Джордж Шеферд 


по материалам Дэвида Круглински 


Издание второе 


М 


1СГОЗОЙ`„ . 
Пет 


Оглавление 


Благодарности ХХ 
Введение хх 
МЕ МЕС ИАН ооо даа осо лата 9 лера она ва хх 
УВВ Е ИС ее еее беде борту а обл во Иа ка ХХИ 
МЕТи платформа Та... иле иьийнлоротии, ЗВАВЫ РО ХХШ 
Комуадресована. Эта КНИГА... ии. ИЗО ЛИИ ХхХхШ 
Чо не вошло ВКНИТУ ло Зе ГН рмиратЕЯО хх 
КАК.ПОЛЬЗОВАТЬСЯ КНИГОЙ, ег, ПРИНОСЯ 9,4 
СТруктур&кНиРИ- лилии, ЗО ВОЧЖЕЫЯ, хх 
УЗ или 16 оао пов свинодвотодопиьнио Норов змий ХхХУ 
Требования Системе! ...... ионы. ВИТО НРАЕВЫОЛИХХ.. хх 
Примеры программ на прилагаемом компакт-диске ................ ен нннннь ХХУП 
Дополнительные библиотеки УЛп4о\$ ЕОМп$ ........... нии ньнининь нь ХХУП 
Поддержка рлььнь . ВОФОРЯ НМЕЧОТЯЕА О 2 ОаТОмОЯЕИЕ ХХУШ 


ЧАСТЬ 1 
ОСНОВНЫЕ СВЕДЕНИЯ О \МММООМ/$, МЗЧАЕ С++ .МЕТ 
И КАРКАСЕ РАЗРАБОТКИ ПРИЛОЖЕНИИ 


Глава 1 Мсгозой УИп4ом$ и Миа! С++ .МЕТ 2 
Модель программирования в УЛпЧ0\$ ............. неа лннннниньти ту ниннниннтнний 2 
Обработкасообмений сай... ирония обв 2 
Интерфейс графического устройства .............. нии, 5 
Программирование, ориентированное на ресурсы .............. инь» 4 
УПРАВА МИ Мише и ео уменя - 
Динамически подключаемые библиотеки ............. ин ннннннььньь, 4 
Интерфейс прикладного программирования 1132 ............ аа ньнниьи: 5 
Компоненты изо И, иене ккикь ВНЕ... 5 
Мисгозой У!15ца! С++ МЕТ и процесс сборки программ ............. и енннннььь: 6 
Редакторы ресурсов и просмотр ресурсов проекта ............. ини ннние. 8 
КомиилЯтОр ОЕ РИН ВИ ЛЬ оно ато, паями... 8 
редакторивходносотекатату ион оанихониа озтаскнетОмаА ...... 8 
Компилятор ребУрСОвТЯ ИХ, ,„Зеигадолкомааи.астеналииот итетовдкеИТ...... 9 
КОМОК И ея ой Завиаэнсь,..... 9 
СОНИ Юр ьькеаие НОРАУНЯ УМОВ...) 9 
МЕС МАЕ, Зуя, ОЛА НЗ ДЕСВЕИ В врикыейТ.... 10 
ОКНО ДОУ ринку веОбЖаолнУ ев они риноЬ. о. 11 
Средство просмотра исходного кода ........ кии нана или и, 11 
ЗОНОЙ Я Х, уро НТО кинза миске Чео. 1Ё 
ОБСЕ ли леланилолоов о очи имисловаобоситламыко 9... 12 
УМЕинСтрумонявиль о зоика и каооманыюлосвааозатламымшоя.... 12 
Интерактивная справочная система .......... ен нанньь 15 
Диагностическиевухилигы лоси о. ЧоОун аамыютг.... 14 
Библиотка МЕС ВВС. ,,.. „реке ии енота аи вн талия ЛЯТЯМИН, ММ... 14 
Библиотека версии. ...,,,..,,,.,,,,..,,,.,,. ЗОЯТУОЖОСИ 2 ВИО 14 
ПоддорЖЮМЕТ ИЛИ усов омонрмемау, ошатодове эхо, 14 
Глава2 Каркас приложений МсгозоЯ РоипдаНоп С!азз$ ЫБгагу 15 
Назначение каркаса приложений ............... ии ние 15 


Путьукоторый вам аредстоит ух, ихрелеыьски о рывеннови. двинен изн, 19 


АД] Оглавление 


Варкасприложенийх........... ен ИРИ... 20 
Каркас приложений и библиотека классов ........... 1 ини нинннь, 20 
Пример приложения на базе каркаса приложений ................ неа нннниьь 20 

Сопоставление сообщений в библиотеке МЕС ............... н.а енинаньнь, 23 

ДОН Е  ДОВНВОС ОИС... 1... еб инь 24 

ЧАСТЬ ГИ 

ОСНОВЫ МЕС 27 

Глава 3 Знакомство с мастером создания МЕС-приложения 28 

ПИЯ КОСАВИЛ» зала обла еее аа грозило ВКО АЗОТ ВТ 29 

ЗИ МЕС-ПРИЛОЖЕНИЙ ........-... льна аа риа ова лики ВАНЯ БЕ ВИЗЯОООЮ РВ 29 

Пользовательские интерфейсы МЕС-приложений ................. ини нннинниь. 29 

Фример ВхОЗа: зпустоекприложевиелио ти дома МЕС ели аЬвоевЬсях: 50 

Ваяос СВОЗа\емалел дис. язы Слона рАиыЯ неерЯ 553 

Рисование внутри окна представления: УЛпадом$ СПГ ............ нии иеанннннне: 54 
Фувклия- член пота”, позлокиоста Мы оное Уривинисей 34 
Контекст устройства в УПЧ це лети момоколинонаы малое иерадь 34 
Добавление кода рисования в программу ЕхОЗа ................:.лнненнинннния 54 

Нерзое знакомство с' редакторами ресурсов... ен реален нь ЖКУ 56 

о о За ра ьу обевеоЗрОР  ЕЕАО КАР 36 
Работа с редактором диалоговых ОКОН :...... 1... аа, 6% 37 

Конфигурации РеБиз иКевазез алиса киа ДДИеОЫи 58 

Предкомпилированные заголовочные файлы ............. линии ина ньниникаятннннинья 58 

Два спо сООа За СВО ан. 40 

Глава 4 Мастера \М!зиа! С++ .МЕТ 41 

Зипььмастеров Алексея а ирвОнОвОСТА ВРУ 41 

Какработают мастера понос, Це оно ОсУлитОоячыст | 42 

Создание Мастера Пол. ЛАТАНОЧМ ЗОН ФЕА оПоФЯТНИЯ.... 43 

Создание мастера для разработки \еБ-приложений на управляемом С++ ............. р 

Глава 5 Сопоставление сообщений \Иптаом$ 51 

Прием вводимых пользователем данных: функции карты сообщений ................. 51 
Картасообщений. . озу лоль аку ууааачиь , ИНЬ АОИ АМОНОГИ 52 
Сохранение состояния объекта «вид»: переменные-члены класса .............. 52 
Теория недействительного прямоугольника .............. 1... ине ннньннны: 53 
Клиентская область окна, «уе лась. МОТЕВЫНИОЙ.... 54 
Арифметические операции с СВесё, СРоше и С$12е ...........11. ние, 54 
Попадает ли точка внутрь прямоугольника? ............. ини ннннье, 54 
Оператор СВесс РОВЕСР: В спласналь виах оная умри ЗНА НОВААОЫ ух 55 
Попадает ли точка внутрь эллипса? ............ зе: ннниннньнн и инь ннньь 8> 
Примерно 5 а, Уго осели КИ АЛ 55 
Использование @ 1255 Мес хОбании ел. поили вю ВИ: д; 59 

Режимы преобразования координат ...........:.. ини инннне, 62 
Режимпреобразования ММИТЕХТАТЛ, „уе еьькнакььнньу АЖА ДОНИЮС.... 62 
Режимы преобразования координат с постоянным масштабом ................. 63 
Режимы преобразования координат с переменным масштабом ................ 64 
Преобразованиекоординат. .........: АИЗТОНОБНЕОВЕИИО ДЕННЯНИТИМ.... 66 
Пример ЕхО5Ъ: переход в режим преобразования координат 
ММ. НОЕ. ‹., елена реак И ба... 67 

Фкно.представления спрокруткой .&.. олясииесик иен иоимАЯя ..., 68 

° _ Окно — это больше, чем видно наэкране.......... Инь. 68 
ЛИНОЙВА МоОкоУки амер еоя ааа АС оном, 69 
РАВЛИЧНЫССПОСОЧЫ ПРОКОУТЕН , лота. нение званию новь 69 
ФункцияОщяна раже +, за. озааииееие но 3 ПАНА, БОЕ САН 69 


Прием данных, вводимых с клавиатуры ............ ие анннньь 69 


Оглавление МИ 


Пример Е ХО5с: прокрутка: .. еле ДИТ, КАЗАКА 5. 70 
Другиесообщения УЯпдо\ $... ЗАИоЛОЛНАЬНаЙ СЛОЯ оНилиАюИЩаНит 73 
Сообщение УМ.СВЕАТЕ, иены пло... БЛОХ ЖНЫОЕАНОЙ ЧОДЕРТ.... 73 
Сообщение УМ. СГОЗЕ ...... 44 АЗОЯЗлемыкрочланиваовитиячая 73 
Сообщение УМ: ОЧЕВУЕМОЗЕЗ Мол оон ра Косимова... 73 
СообщениеЛИМ ИЭЕЗТКОХ Е ол ь к ПРО ДАООАЧЕИ..;. 74 
Сообщение УМИУСВЕЗТВОХ:. т... 333: ТОЧ дОвкитонНаАРСНАИАЯЫ . 5. 74 
Глава 6 Классические функции графического устройства, 
шрифты и растровые изображения 75 
Классы контекстаустройства: о аьььоь. КОДОВ НОННА ЗОО НИ 75 
Классы контекста дисплея ССПеп{ОсС и СУЛп9о\ОС ......... нина 76 
Создание и уничтожение СОС-объектов .......... иене аннннни, 76 
Состояниеконтекстаустройстваотрны зинтневнела кота аниовсиояиц.... 77 
Класс СРаши 6 <, злее лььннье, НОЙФ НН... , 4 
Объекты ОГовь ооо уаааинеюЮвролон оо оли иНЬНАОЯ..... 78 
Создание и уничтожение СП]-обЪектов ............. ини иненнннни 78 
Управление СП[-ОбЪъектами . ‘нал, ЛИДО ЗУМА 79 
Стандартные соГобЗекты: : 34. НОНО НОО ДЕРАЗИУАЛУНЕН ДЫНААЕОН.... нА 
Времяжизни контекста устройства „..;... ОИ ИОАНН... 80 
Нрифты ео кина ВН ОТОЯОЛОАНА ЗОВ РААНИЯ 1 .:.; 81 
Шрифтыкак С ОГ-объекты. Фа поновенАлонаиаиаЕ сини, 81 
о а ое ии ар 81 
СНЕ В овен оз окаалан ны 55 ВМО Аа 82 
Отображение шрифтов’ надиенлеет т гие гм НИИ ЭРО НОЙ 82 
Логические и физические дюймы на дисплее ............. нее ьненннни: 85 
Вычиелениевысотьгсимвола”. 3. ‹/..... ЗОНЕ ООЛ ВИЗА ТА т., 84 
Иример` Вобис, АООТ ЕНЯВЕ Ро из ооОнН» ВНИавАНОИ ДАЛЬ ре 84 
Элемеёнты‘программы ЕхОба. : *иозилз ПРЕ я Я», Вани ПИЛИ: 87 
Нримерв бб ЦС, сини оЧЕ внногаячну тнлЕ ВН: 88 
Элементы ярограммы ЕхОбЬ ооскькнис ИЛИЗИ ДРИ ЗОН... 90 
Пример хобегеноваЗетой\Н ему. ‹; ВИНОВНАС А ТИСИЗСЯ ЗАНТАЯКНЕТО ТОХА М 91 
Элементы программыехобс от инаиохазиитоаниТо ри. ие. 95 
Растровые ‘изображения и г. осле НМ АЧЕЛЛИТ СВ ПОЧВ ДЗ... 95 
Радтровыв изображения СОРИ ИВ Акане МИ ЯЗЕАНЮ 96 
Цветные и монохромные растровые изображения ................ зн енныь. 97 
В В-изображения иклаес СГЛЪ. ‚,.;уедаьилььа,. МОЙЗЫИ?.ОО ДОН 2ОННаЧИИНЕА.... 97 
Несколько слов о программировании палитры .................:енннннньнанние, 97 
О1В-растры, пикселы и цветовые таблицы .......... нение ивннь 98 
К О ен еоеиваа зна 99 
Пунклилля аб ОТАСТИ Ве И ЧИНогаБаеиномо те лана вие 100 
Класс ВИЗА во Нодеаак ао отона я моче ана 101 
Производительность при выводе ОГВ-изображения на дисплей ............... 106 
Примерное а. :...;; АННЕ ВОТНЗМ Е ХаНЕМОР В ЕН НАЕВИ... 107 
Ее несколькосвов о ОТВ: осилил аи пота сааея 109 
О КО о ОО 109 
Функция а а пани Он: 110 
Растровые изображения на командных кнопках ............ еее ннненнннье я 111 
ПРИМЕНЕН О О пива АЕ оО ТИ Ново... 112 
И еще пара слов о растровых изображениях на кнопках ..................::.... 114 
Глава 7 Диалоговые окна 115 
Модальные и немодальные диалоговые окна ............... нение ни енеиньннь» 115 
Весурсьииадементьнуравления ›. леонид ь 115 
Программирование модального диалогового окна ............. ен еееннннн 116 
Пример ЕхО7а: Диалоговое окно «каждой твари по паре» .............. ее еннньь. 117 


Построение диалогового ревурса .. а еВЧО. 2, Нота 9 117 


УШ Оглавление 


Созданиекласса «ДИАЛОГ»............ али дааньль БО СВООИЕИТ 123 
Подключение диалогового окна к классу «ВИД» ............ али аннни: 127 
Разборжриложения хо 7 сл. зариакаилиокеми ДАЯЯО. МИЯ аниощАюа... 129 
Усовершенствование программы Ех07а .............. ини или наищань, 150 
Перехват управления при выходе по ОпОК ............. ии нинннь: 130 
Обработка ОпСалсе....,..... аллеи ПОЯТОЯЫ, МГ ЗиВиОесЬ 151 
Нодклюнение полос прокрутки, ...,.......,.. ХОЯТеноои. м амищавана... 132 
Доступ к элементам управления: С\/па-указатели и идентификаторы ................ 133 
Фон диалогового окна и цвет элементов управления .............. ани нннннань, 154 
Добавление элементов управления во время исполнения ................:.... аа... 155 
Другие возможности элементов управления ............. нии ли нинииананание, 155 
Стандартные диалоговые окна УЛп4о\$ .....:..:... лань инь ива льна инь, 135 
Прямое использование класса СЕЦеГ\аЮ8 ...........:. знании нинанннь: 136 
Производные классы стандартных диалоговых окон ............ 1... ннниниь, 136 
ВИОЖЕНИС ЗНаНОГОВЫХ ОКОН. ем о. 126 
Программа-пример ЕхО7Ь: использование класса СЕЙеГ\а0 .................. 137 
Прочие возможности адаптации СЕЙеГ!аЮе ...........:. линии ннанинниньние 142 
Немодальные диалоговые Окна аа О, Знаний. . 143 
Создание немодальных диалоговых окон .........1...... а линннь ил ннниьььнна 145 
Пользовательские сообщения. .......,. пион ово чвенамеаН ... 143 
ПРинадоекность диалогового ОКНА - ‚рии инь О 144 
Пример ЕхО7с: немодальное диалоговое окно ........ ини ниаинининань, 144 
Глава 8 Стандартные.элементы управления 151 
Знакомство со стандартными элементами управления ............. и лннннннии, 152 
Элемент управления «индикатор хода процесса» ............ нии инннннньнь, 152 
Элемент управления «ПОЛЗУНОК» ............ азии анали, 152 
Элемент управления «наборный счетчик» .......... нина илнниниилнниния 155 
Элемент управления «графический список» ........ знали ини нанань, 153 
Элемент управления «древовидный список» ............... ини ианитиилиниия 154 
сообщение УМ МОТЕУ, „за, аиооеаанюь ОО хЯааммоииыамаае . .. 154 
Пример ЕхО8а: стандартные элементы управления ........... нии нинанииииинии 155 
Дополнительные стандартные элементы управления \Ип0\$ ................ 166 
Элемент выборажатьи воемени: ‚. динаров ТЕ ЗО 167 
КАЛОВДАВЬНА МЕСЯЦ ‚рр нькк ЗВН оонавикадовы зыукоа 167 
Элемент ввода 1Р-адреса нь зжьке высер кре еаоврЕСИнНьь а Сато 168 
Расширенное поле.со. СПИСКОМ, . „некое л нь» НОА ие НОСЫ, 168 
Пример ЕхО8Ъ: Дополнительные стандартные элементы управления ................. 169 
Глава 9 Использование элементов управления АсНуеХ 181 
АСсНУСХ и обычные элементы управления УЛп9о\$ ........... нии ниньтинтянинь, 182 
Основные характеристики обычных элементов управления ................... 182 
Общие черты АсНуеХ- и обычных элементов управления ............: нана... 182 
Различия АсНуеХ- и обычных элементов управления ........:..:....зньниннььь. 182 
Установка элементов управления АСНУЕХ ,.....,..,.. НЮ ван Омана, 183 
ЭДЕМЕНЕ У АНЛЕНИЯ ЕВС ЗЕ ея отаку нь зов нь и бе О ОВ аниЯ 185 
Программирование контейнера АсйуеХ-элементов ...... а. ннинньнинань. 186 
ДОСТУН К СВОЙСТВАМ, ..,.,., еле МБА чааЕвАЕЕОкААя сос пъынсковровы она 186 
Классы-оболочки С++, создаваемые У1зиа1 $ о МЕТ ; 
ДЛЯ АСВУСХ- ЛЕМА ее он сокс ааь Зоне ое О-В. 187 
Поддержка АсйуеХ-элементов в МЕС АррИсаноп УЛгагА ........... а ненинье, 190 
Мастер Ааа С!а$$ УЛгага и диалоговое окно контейнера ........................ 190 
Закрепление элементов АсНУСХ в памяти ....,... алии изьититненининння 191 
Яример. Е 094: контеныер АСИУЕХ ›..::... ноль, ль РАНЕНО НЗ 192 
дочуеХ элементы вх МЬ-Файлах оно севолононюданлио оникса ос 199 
Создание элементов АсйуеХ в период выполнения ............ и... нина инанининниния 199 


Пример ЕхО9Б: АсцуеХ-элемент в браузере .......:.;. лиана нинииь и нина инь нь 200 


Оглавление 1х 


Свойства-картинки... 5. ие ИЛИЯ... 204 
Связываемые свойства: уведомления об изменении ............. нии 204 
Глава 10 Управление памятью в \!т32 206 
Процессы и адресное пространство ............. иене 206 
Адресное пространство процесса в \Лп4о\$ 95/98... нина 207 
Адресное пространство УИпао\уз МТ/2000/ХР .......... нение 208 
Устройство виртуальной памяти ......... инет 208 
Функция Ушиа!АПос: переданная и зарезервированная память ......... +... и 4 
Куча УЛпо\$ и семейство функций С!оБа!АНос ......:... и еенииннннн 213 
Куча малых блоков, веарпил и операторы пе\ и еее в С++ ...............4.44::.... 214 
Проецируемые в память файлы ........:. ен 215 
Доступк ресурсам лилии оо АНрАИАиОрОИм лада АЗИИ... 216 
Советы по работе с кучей ........ Инне 217 
Оптимизация хранения констант ......... нение 217 
Глава 11 Обработка сообщений МИп4о\$ 
и многопоточные приложения 219 
Обработка сообщений У/п0\%$ ........ ии иен 219 
Обработка сообщений в однопоточной программе .............. нь н 219 
Передача управления ............. еее ин 220 
таймерыиа лилии ЦЕЕРИАВИ 221 
Пример Ех11а`;....... еее АИ ЛО. 221 
Обработка в периоды простоя ............ нение нь 224 
Программирование многопоточных приложений ............... иене ньнне 225 
Написание функции рабочего потока и запуск потока ........... инь. 226 
Общение основного потока с рабочим .......... ее ееенннни и 226 
Общение рабочего потока с ОСНОВНЫМ ........ еее иене енннн 228 
Примере а И И Ра иен 228 
Синхронизация потоков с использованием Собирая сил 250 
Примере И ВОДУ гого Ее 250 
Блокировка потоков’... оли И 252 
Критические секции .......... и: 238 
Мьыютексыги семафоры рено лил ИИ 234 
Потоки пользовательского интерфейса ............... иене: 235 
ЧАСТЬ з 
АРХИТЕКТУРА «ДОКУМЕНТ-ВИД» В МЕС 237 
Глава 12 Меню, быстрые клавиши, поля ввода 
с форматированием и окна свойств 238 
Классы основного окна-рамки и документа ............ ен ннн 259 
МОНО ОО пе аа оао чи ея СБ ор Ра ВОВ 259 
Быстрые клавиши ...... ен ние еее 240 
Обработка команд ........ неее ление нина ет ОВ Зее 241 
Обработка командных сообщений в производных классах ...........--.-:.... 242 
Обновление командного пользовательского интерфейса ...........-.-.:л:.... 242 
Команды, генерируемые диалоговыми окнами ........... еее 243 
Встроенные меню каркаса приложений ............ еее ини 243 
Включение и отключение команд в Меню .............. ее ниенаинекиннниннь, 244 
Редактирование текста в МЕС ............ нение иен пан 244 
ОС ао еле ооо ИЯ 244 
КОСОВ о чение, ли ренессанс, ое В ВИС 245 
АСС ЩИ О оке ера ен собери оу 245 
Нример 12а „еее оне ели ил ре ЕАННОЛЬ 2 246 


Ри РГА ро роде дб дАНЕ УИЛКИНСОН 251 


х Оглавление 
р ЗИ ГРИН ИЕН ОИ 


СоздАМиЕ ОКНА СВОЙСТВ, лее ниче ЧА-йЯ ОЙ 251 
Обмен данными в окне свойств ее иди 251 
ОО ине неба < ов ани ие 252 
обработкакнопки АррИ,. каз. 2 С"ЗТАМБИ ЭМНОЛОНОИХ 91 ва 263 
ОИСИ Ц енко уе чин оны це ОНТОНИОРООКИТ ЗОНА ВОЗ 264 
О&8даниеконтекстных. меню 50 20 лисой колоде овтонаатаюсньэаназалх. ... 265 
Рабширеннаяобработкакоманд. Эно и етовли оихоалотоолиь занаущь. .., 265 
Глава 13 Панели инструментов и строки состояния 267 
Панели элементов управления и каркас приложений .....:...... али 267 
МАНСЛИиНСТрументов, „аа зазаь ы лоу, ваотваэло.н, пила й, Володь, 1 268 
Растровое изображение панели инструментов ............. анна 268 
Состояния кнопок панели инструментов .......... ани ци, 269 
Панель инструментов и командные сообщения ..........1.... ааа, 269 
Обновление пользовательского интерфейса для панелей инструментов ..... 270 
ВоплВа О СА ро ола п а 271 
Цоиск основного окна-рамки, ионная а ея ее ОВ ЧИ ТТ Ва 271 
Пример Ех13а: работа с панелями инструментов ............. ани 272 
ОТО ВО ЕО ео нана роке ОВАЛ Пина оды 276 
Определение секций в строке состояния ............. линии нь, 276 
БОКА ОВОЩеНИЙ иона ад олеиицькь, ЗыАЗАКИ НКО... 276 
ДИКА ТОВ СОСТОЯНИЯ ое еек иван ово ьние ААА. 277 
УПРАВЛЕНИЕ СТРОКОЙ СОСТОЯНИЯ... онечиньнниньь лоно ИЯ МНЕ... 277 
Нример'Ех То Бзстрокаеостояниямянты ПОЗА НИЕ. ротооди меонааня диаав 278 
Нанель инструментов Вераг.. ебли иыитотонолони эмаквокиыькек 282 
Внутренняя структура геБаг-панели ........... ини, 283 
Мример Ех Эе-кеаспаНеДИ дамунекчценки Зи ООВО 2 БлОТОНОЗОмНоноснизию),... 285 
Глава 14 Повторно используемый базовый класс окна-рамки 287 
Почему так трудно создавать повторно используемые базовые классы ............... 287 
Басс ОБСТРЕЛЕ. алла ок Я ие. 288 
Класс СЕгате\/па и функция-член АснужеЕгате ........... нии енниннни нь. 288 
ВНК ЛЕВОМ Одень иене нь Баев: 289 
В О они обв еее к оао ЗОВ МОИВИ, 290 
О нае оеоиеи Бобик аНтАяОвикст НОС. 292 
ПОЛНО САВА ЗВОН ОКНО оо ооо оазе оова выиа 293 
Состояние панелей элементов управления и реестр ............. анна наьннни 294 
Статические переменные-зленьузал Я „пая ль Лир АСВ 294 
Оконный прямоугольник по умолчанию ............ ини нина ниннннн, 294 
Пример Ех14а: класс постоянного окна-рамки ........... анна наи нана 295 
Постоянные рамки в МП!-приложениях ...... Обои Фа Ко. М Злраавнаснотевасие» 299 
Глава 15 Документ и его представление 301 
Функции взаимодействия «Документ-вИД» ......... анна: 301 
Функция сено ссоепЬ ии АСЯ НОТ 302 
Функция СРоситеп ОражедН\еуу$ ‘..,;, писали аЕМОй БАТООв 505 
УНИАН и Ней ВЛТОСАЧО 7. 505 
Функция сем оцитнята аа”. о О ОТОВАНЬНОЯ ЗНА ОНО? › 505 
Функция СРоситепе:ОпМе\Воситтепе И... 504 
Простейшее приложение в архитектуре «документ-вид» ................. а... 504 
Г И а а А А 505 
О В Ааа НН 506 
ДНО ао ее ть ООО ЯМА. 506 
а оо ООН ЗОВУ 506 
ОЕ НА ее ПОНИ РЕ. 506 
Класовьоритроомехси о есь ина ооо ТА ЧР 307 


Автоматическая диагностика неуничтоженных объектов ....................... 508 


Оглавление х 


Пример Ех15а: простое взаимодействие между документом и представлением ..... 510 
Усложненное взаимодействие документа и представления‘ ........... не енньннье.. 316 
Функция СРоситепь Ре! еСопепи$! зло амореиАИ ди, инориинь ЦА ИЕ... 517 
Класс набора СОНИ$Ь „елена или ани лиитнииии или НОСОВ ром 518 
Применение класса СОЫ4$ для создания списков типа ЕЕО ................... 5318 
Перебор элементов СОША$е: переменная типа РОЗТПОМ ..........:..14:.4.... 519 
Класс-шаблон набора СТуреаРи1Т4$е ............ ранил ниирлия ЗЕАЯБЗЯХАХ : 520 
Диагностикаи классы наборовт»......... ха вииожолычи высадить +. 929 
Пример Ех15Ъ: $01-приложение с множественными представлениями ............... 522 
Требованиякресурсамис я клеи бвнзжовыеть ГГ Мою Я. орямнер о. 523 
Требования кодузциосви иносака енко энывнокияси м... 524 
Перемонивюе-вленыму. спролочняе. СИС, р, у ко ео ее ча 35 
Защищенные виртуальные функции .............. нии ние нение 997 
Тестированиелрограммы Ех15Ъ........ ии ли ии зоо ланаа нии ПОПЕ Я АЛ 83 
Пара упражнений длячитателя............. ищу сиилоь пароли Ти... 538 
Глава 16 Чтение и запись документов 339 
Понятиесериализации илолнимлалии овияронкрстон атомлодалманякотнаьяя 559 
Дидковыефайлы иархивы, ........еллилоьаьи ТЕНТ БН ИОНЫ ЗЛФСИме РС 540 
Созданиесериализуемого класса лис кнззлыхка м зааллаыера ля ... 340 
Созданиефункциие нае... ие лииоитониьониь « ИМАЧЕСТАНОГО ИНЫМИ... 341 
Загрузка из архива: внедренные объекты и указатели ................::114::.4... 542 
Сериализащиянаборав тия. Г, лилии конки риие НЛАОРНИЗМОМВЬОЩАЮЯЫ... 543 
Функция 5епаН2е и каркас приложений............ ние инннии 344 
ЗВЕПриложениев уе, „рии коли зоорровииоириини ТОВ НТОВЫЮЮ ЗЫНаПОДООН... 544 
Объект-приложение УЛадо\у уд оогозиочобщиьжаноловиижасовии о пхо, 545 
Классшаблонадокумента’... пннызохнюны вт ьмыесноце Чт кд ам 345 
Вбсурс шаблона документа... и иене ее еее оаы дыни 547 
Множественное представление документа в $01-программах .................. 548 
Создание пустого документа: функция СУЛпАрр:ОпЕШеме\ ................... 548 
Функция ОпМе\Роситеп: класса «документ» ........... ен нимнииия 549 
Связывание ЕЙе Ореп с кодом сериализации: функция ОпЕЦеОреп ........... 549 
Функция РаееСотепи класса «ДокумЕНТ» ....... иене 550 
Связывание ЕЦе 5ауе и Ее 5ауе А$ с кодом сериализации .........:......::::. 550 
Флапизменения документа}. „ууу кино руркоракииьек НИМ ООНИМЫ 550 
Пример Ех16а: сериализация в $О[-документе ........ енко. 551 
СООО НИЯ ЭКСПО КСО, руке гру ке ВАО ея 352 
СЕХТбаАррульноять лом рр гр ленив оба р. 2 552 
СМамемяте о уизолнноеоне ва наозентало с оынжоныдиА Ч кЗаом 556 
ЮО бро сстоыя КЛИНА СИА рр рарнянь ОЗ 558 
СРО ПУХ Тир АРУ ТИУЮОМ,МО И иле а ее. 360 
Тестирование приложения Ех16а .......,.. иене иеикикикь РОМЫ 560 
Запуск программ из УЛа4оу/; Ехрюгег и операция @га-ап4-Чгор...........:..:::.4..... 560 
Регистрация пропраммагеь& «лил иронии ука энное секас 360 
Двойной щелчок документа, ррркини нк, ео аВОВНУЕЙЕ г. 561 
Активизация механизма агаз-ап9-Чгор ....... ини нии ннн не. 561 
Параметрьгзапускапрограммы: /;/.,,оВтиЯвиноковни днномощетовт... 561 
Эксперименты с запуском программы 
из УЛпаоу’з Ехр!огег и операцией агаз-апа-Чгор .......... нение. 562 
Работа с документами в МП!-приложениях .............. иене ееннние, 562 
Типичное МП!-приложение в стиле МЕС .......... ини ини ине. 562 
Объект«МОГ- приложение тли у оовуея линии ние знивабаетох. 564 
КлазонаблонеМОГДОКументя хо, ооо еее ее 564 
Окно-рамка и дочернее окно в МП!-программе ............;... нение, 364 
Ресурсы основного окна-рамки и шаблона документа ...............1:..:.:4:4. 566 
Созданиепустого документах ЭХ НО, инки, НН ув норовье той 566 


Создание дополнительного окна представления для существующего 
О 367 


ХИ Оглавление 
па вании попона проживании пан ианпиннни, 


Загрузка и сохранение документов `........ ии 367 
Множественные шаблоны документов ........ или 368 
Запуск МОТ-программ из \Ип4озуз Ехрогег и операцией @гав-ап4-@гор ...... 369 
Пример Вх16Ь: МО1-приложение ......... еее иьииониь. КИЙОЛИДОВН О: 569 
СВхЛбЬАрр... (2213 донтлохзияовналяеол А вЫЯОЛ доллнх ниенамнац... 369 
омыавгатениск ОАО дозгглениаисоаи лено Оилизченоваари... 373 
СОВА ЕКА, Кома еньонучьньчь ЛОРИ АЧООЕНОИОЗОМЕ-ЕКИ ... 376 
Тестирование приложения Ех16Ь............., ЗОО ООН ВИННИ... ВХ 
Работа с документами в МТ!-приложениях .......... нии 378 
Пример Ех16с: МТ!-приложение ............ Инь, 578 
Тестированиеприложения Ех16С чеки ИВАНЕ... 379 
Глава 17 Печать и предварительный просмотр 380 
Пебать вдохов команимие скорее аммЕППОЗНОКОТ . 580 
Стандартные диалоговые окна печати ......... и. 381 
Интерактивный выбор страниц для печати ............ лиан ланьзинананаы, 382 
Экраниыстюненатьвнюстраницы и 582 
Предварительный просмотр перед печатью ........... наи 5382 
Программирование вывода на печать ......... ани, 385 
Контекст принтера и функция С\Ме\:ОпОга\м ........ ие. 585 
Функция СЯ вся ОВРИПЕ, синь ЗЙЕИЗОННИИНУФЭАНЫПЕОХ... 385 
Подготовка контекста устройства: функция С\У1е\':ОпРгератерсС .............. 384 
Наналолвконециечатисковния . еее ЧОН ВЫНЕВНЩАНОХХО ... 584 
Пример Ех17а: печать в режиме \/УЗГУУС 9... 385 
Опредбленисобудети печати. +. ее линиац ВНЖ 390 
Еще раз о классах-шаблонах наборов: класс САггау.....1... 1.1. нньа 391 
Пример Ех17Ь: программа печати многих страниц ........... ии, 592 
Глава 18 Разделяемые окна и множественное 
представление данных 397 
РАЗДеЛЯЕМОЕОКНО О ода. ТОМУ» БОБ ПОПИОСТаЗИ О ВНИЯаУФ 397 
Варианты создания множественных представлений .............. аа... 398 
Динамически и статически разделяемые окна ................. ана, 398 
Пример Ех18а: $П1-приложение с динамически разделяемым окном 
И ОДНИМ КЛассом-«ВИД»- вл узлу ль лььлььт, БЕМОМУЛОД АЗНОНЗМЕН ЕАО, ,, 399 
Ресурсы для разделения окна. ..... У2НаМУИО АО еНИдамдЕНавА МОЯ ЭМ 599 
смангатен рае О 400 
Тестирование приложения Ех1 82: кои инанил ЧАВО Я... 400 
Пример Ех18Ь: $П[-приложение с статически разделяемым окном 
ИДВуМмяклассами яви дь ое Панель ООО ОВ, ., 400 
ОНек\ ея СПИ ОЖСНАКХ ро алла ЗОО НЗ. 401 
СМамЕ аще, лед але ааад зал ВОН ВННОЖОВНЯИ ЭННУОЧНТОЭТ... 402 
Тестирование приложения Ех18Ь ........... ина, 403 
Пример Ех18с: переключение между классами «вид» без разделения окна ............ 403 
Требованиякресурсам цел. нь, АПИЗМУЖЮД ДОРА ПОНИОЯД, .. 403 
смашеатесня расса ВА ЕМЕННОХ УМ ВННЕНОВИА,. .. 403 
Тестирование приложения Ех18С.......... НИМЛОЗОЯЛ ЛИЕЕОЗИТОЕЦ,.. 405 
Пример Ех18а: МО!-приложение с несколькими классами «вид» ...........1........... 405 
Требованияк ресурсам. зеркале ИзНияалио наи оков ЕН... 406 
СЕХАЗААВВ И р они М ИМеТНОМУХОВ ЗЕД 406 
СМА Ме +леьазилони, МИРАИЗ А РНКОДЫНТ- КАМ ЗОМРЮНЫТ, ,, 407 
Тестирование приложения Ех184 ....... иль, 408 
Глава 19 Контекстно-зависимая справка 409 
уУпнериНТМЕНЫрт», ‹.. АТИЛилиОО И ЗАО АНИО ОПИАОНО НЧ... 409 
\пася-программаге ХлаНер ини ьь, АТАЗМУАР ТОТО ЭННЫЛЕО. .. 411 


Текстеформатированием нуля ила ли овИолодлиНеААо.... 411 


Оглавление хи 


—_—=—щ————————ШШо————ддодо—о— 


Подготовка простого справочного файла ............ иене 411 
Совершенствование оглавления ........... еее 416 
Каркас приложений и \пНе]р ............. ен 416 
Вызов УЛаНер о еее еее иене ее еее 417 
Поискстроксаиися давл дотого 418 
Вызов УЛпНер из меню программы ............ ини 418 
Синонимы контекстной справки .......... неее 418 
Определение контекста справки ............. нение 419 
Вызов справки клавишей Е! ......... иена еее инки инет киеннния 419 
Вызов справки сочетанием клавиш ЗМИЧЕ1 ...........:. неее ннение 420 
Справка в информационном окне: функция АЁхМеззазеВох ................--.. 420 
Стандартные разделы справочной системы ............. неее 420 
Пример создания справочной системы без программирования ................--.-... 421 
Обработка команд вызова справки ............. ине е ние 423 
Обработка клавиши Е! ....... ние еее 425 
Обработка сочетания клавиш ЗЫЙЧЕ1 .......... 4. 424 
Пример Ех19Ъ: обработка команд вызова справки ........ неее еее нь 424 
Требования к заголовочным файлам ........ иене инея 424 
СОВМ Е НО лльенаио ни иньил воруй АЗОКОу ИЕ АНИ СУ 424 
снеаех ольския деньги Неро ре ООМЕАЕЛ, зерне р 425 
Требования кресурсам ......... ление елне линии кения алии 425 
Требования к справочному файлу ........ нение иене 426 
Тестирование приложения Ех19Б .......... еее а атае ние 426 
МЕСи НАМЕТ О а И Е, к леозоенеилиз нал ьны рН Зи 426 
Пример Ех19с: НТМГ Не] ............ еее иене 427 
Глава 20 Динамически подключаемые библиотеки 429 
Основи НЕ ле череп веваь ИУ НЕ Ра Аи сРурА 429 
Согласование импортируемых элементов с экспортируемыми ..............:. 430 
Явное и неявное связывание ............ еее ен ннеин ни чине ни ан 431 
Связывание по символьным именам и порядковым номерам .................. 432 
Точка входа в О: функция РИМашт ...... еее 433 
Описатели экземпляров и загрузка ресурсов .........-.. нение 433 
Порядок поиска ОШ. клиентской программой .......... иене нение 434 
Ола Е лун ено дования кои оО 454 
РИ.-расширения и обычные ОШ, ........... неее е 434 
РИ расширения: экспорт классов ........ нение 435 
Последовательность поиска ресурсов в ОШ-расширении ................-..... 436 
Пример Ех20а: ОИ.-расширение ....... 4... еее 436 
Пример Ех20Ъ: тестовый клиент ОИ.-расширения ........... лее неннни + 438 
Обычные О; структура АЕХ_ЕХТЕМОМ_МОРОГЕ ......... еее ееиенннннея 439 
Макрос АЕХ_МАМАСЕ_5ТАТЕ .............. еее еееанкия иен иеня ними вене 439 
Последовательность поиска ресурсов в обычной ОМ, .......-. ел еееененнньеа 439 
Пример Ех20с: обычная ОМ, ........ иене яние ениннне 439 
Коррекция Ех20Ь для проверки Ех2Ос.АИ ............ еее нининннне 441 
РИ, с пользовательскими элементами управления ......... ние нннннн ее. 442 
Понятие пользовательского элемента управления ..............еееееиннинн нь 442 
Оконный класс пользовательского элемента управления ..........- нее. 445 
Библиотека МЕС и функция ХУ/паРГОС ...... еее неее 445 
Уведомляющие сообщения пользовательских элементов управления ........ 444 
Пользовательские сообщения, направляемые в элемент управления .......... 444 
Пример Ех2094: пользовательский элемент управления ...... еее. 44 
Коррекция Ех20Ь для проверки Ех204.АЙ ....... еее ини еее неннннн 449 
Глава 21 МЕС-программы без классов «документ» и «вид» 452 
Пример Ех21а: приложение — диалоговое окно ....,... иене нение ини 452 


Функция шоалсе класса приложения ......... еее иене 454 


ХУ Оглавление 


Класс диалогового окна и значок программы ............ и... 455 
римерЕх2: 5 программа ксисумеьетом... АНЫЗАВЕЛО НОЛАН... 456 
ИримерЕх21сМОГ- приложение. из ьклросекоы скота ОВО Я 458 
ЧАСТЬ 4 
СОМ, АЧТОМАПОМ, АСТМЕХ И ОЕЕ 459 
Глава 22 Модель компонентных объектов 460 
СНОВ РеНОЛОРИ НАС Не МИ К, елок ПИБ МАВЬИ НО БОБА 460 
отаку мае УВЕ ОО ЗИ МИА АЕИСААИЯЫ Е. , 461 

Бущоет ОО МЕ Е ЕКО О МОННОВЕМаООНЫ Я 5ИАОТЬС.. 461 

О ВН 1 462 

Интерфейс Опкпо\’п и функция-член Оцегупие! асе .......................... 467 

Учет ссылок: функции АЧЧВе! и Веа$е .......... 469 

ФаОвИКИ Каса АО ОКИ Ча ол льны ни НИВА ТОО... 470 

АСЕ ОО ОИ Е ВЕНЫ ЗАРОРАЧЮСЬ, .. 471 

пример'Ех22а:чигрушеннаяе СОМ”. ой Зе ОАК ЧМ 472 
Настоящая СОМ с применением МЕС... Л... 479 

СОМЕФункцит Обо нО ОБСЕ ооо ЧО, 479 

СОМ РЕСЕГ РОЯ Ле УВЫ АИХ оо ола ИЗ... 480 

Регистрация объекта в период выполнения ................... ааа ннааьа, 481 

Вызов СОМ-клиентом внутреннего компонента ................ ааа нниаь, 481 

Вызов СОМ-клиентом внешнего компонента ................. ааа иланан:а, 483 

МЕС:МАкроеври и ерфей вов 1 олиломиллая има М 485 

МОВА Ле СОСНА СВО ола НАС КЗ ОВУЧЕМ 486 

Поддержка внутренних СОМ-компонентов со стороны мастеров ............. 487 

СОМ-ЕНЕНННРОаС ИВО МОГ ТАНИ риоя 489 
Пример Ех225: внутренний СОМ-компонент, созданный на базе МЕС ................ 489 
А ИЕ НАТА ее. 493 
Вложение, агрегирование или наследование ................... ааа... 494 
Глава 23 АшщюотаНоп 497 
СоЗданиекомпонентов сендляувА ея леч Н ЗоЧкАПыОВЯЕ НИОТЬНИЮ , 497 
ТОентьгикомпоневтьгАОАНО Я: ВН НОВЧО А, 498 

Мисгозой Ехсе! — лучший У150а1 Вазс, чем сам \У15иа! ВаяС .......... на... 499 

ЗНОСТВАИОТОЩЬИНИВОр В пои НО ННомОО 501 
Интернат а ЗООЛВОООА АН. 501 

ИТР НОАК АК ОНО О ОНЯЬЕОЛ ТН 502 
Варианты программирования в Ашотаноп ................. ини нии нньни, 503 

ИВО ВЕеНЛИ АНИ ПРА в НОЕ 504 
КомпонентАОтанопна баземес ии Ио НОТ, 505 
КлиензАониной на базе Моих ито. 506 
Использование директивы компиляции *ипрог клиентом Ашогтаноп ............... 508 
зутпданнегя“УАВЕА ры икячин: ме иосслчии: чад» ИИА ОМК 509 
КЛАССОВ МАНЕ КРСУ АМ соломе ЗУ ВОНИ ЧО, 5 

Преобразования типов параметров и возвращаемых значений 

ПИ КОМЕНИЕ ЧоК СТНОМОЦЕ ОТОЯЗакотьноеяцой ЭНН! , 515 
римерьйдаотАНоро йе АНИ НИ ОН ОЗОНЕ ловя манной, 514 

Пример Ех23а: ЕХЕ-компонент без пользовательского интерфейса ........... 514 

Пример Ех235: ОШ -компонент Амотаной ........... ааа анни, 523 

Пример Ех23с: $О1-приложение Амогтаноп в виде ЕХЕ-компонента 

отользовательскиюгинтерфейсь м: т ето я бот! 531 

Пример Ех23а: клиент Аиотщаного оно вер пока выааеия. 537 

Пример Ех АЕ клином вааНО Влазь сы аььа пик, СЕН. ВО: а 552 
РОЗНОЩЕВИОНВАНИеВ”У ВА, лее а аи Он 555 


Оглавление ХУ 


Как компонент регистрирует свою библиотеку типов ...........:..::.:::1.4.... 556 
ПО файлесиа: „никелем ри рьовилорро врата рорелеро ли ПАЗ КОЗВНОО НИЗ ОЦИЗИЗЕВТ 556 
Использование библиотеки типов в ЕхХСеЕ! ......... нина ннннь 557 
Зачемнужно раннее связывание, ...................ПтИЛОГи а, мес... 558 
Повышение скорости связи контроллер-компонент ............:.:...::4.4::... 559 
Глава 24 УпНогт Оайа Тгапз{ег: буфер обмена 
и операция ОГЕ агад-ап4-агор 560 
ИнтерфейсравоБебек похзэрнолени лилахакаяр але поэма... 560 
Преимущества РагаОБеси в сравнении со стандартной 
поддержкой буфера обмена ...........3.... Пи инь: 561 
Структуры ЕОВМАТЕТС и $ТСМЕРТШОМ \.. 1... ине 561 
ПОВМАЕТ О МОСС ОВ. «о еьнелазенлилюедиялнлнен  ОБТООВАОНО МЫ... 562 
Структура СМЕБШ Мес о..............ЯТЕТА ЛОТЕ НлОВЦОНИНаОЗЕИСОЙ.... 562 
Функции-члены интерфейса РааОБесе..... 1... ин 563 
Другие функции-члены ШагаОБесе: консультативная связь .................... 563 
Ноддержка механизма ОТ в: МЕС........--еоленалеьлачазданоталнлнлль ДЕЗ АЬ 563 
КлассобеВа Оше Ва... -льиолоьалло „вм ноовомрнойэфаэтиц... 564 
КласссоеразоЕСЬ подо смовофаоливичинаатананэиныаятоажоны... 565 
Передача объекта данных через буфер обмена ..........:..... инь: 566 
МЕС-класс СВесйтаскег позора ЕЕ наукнели тер ета аМ 568 
Преобразование координат прямоугольника СВес таскКег ..................... 569 
Пример Ех24а: передача объекта данных через буфер обмена ......................... 569 
КласссМаше текс Бщонопалнмадаворау потизмолеанаы 570 
Класс СЕх24ар0С. „ль иьььлнлллььлолльламьл ИДДОАБИС-КТИЯМ ВВ ЗЫНБАЕОМ..... 570 
КласссЕх2 даем ис зиоюнанизвяваих.Етномалю похатыхиь... 570 
Поддержка операции ага8-ап4-агор в МЕС... ине 577 
Что происходит в источнике"... нение 577 
Что происходит в приемнике лв 4. ии аи точил... 577 
Последовательность действий при агаз-апа-Чгор ..:...... еек нннннне и 578 
Пример Ех24Ъ:ОГЕ @га8-ап4-@гор .......4. ен 579 
КлабосЕХОЛЬЮ Основ ес лада ВЫЗВАЛ МУВИ 579 
Класс ВХ ем ель иллдьллллллиилалль ЧС. СООО ЧА С 579 
Глава 25 Основы АТЬ 583 
Снова СОМ оон клик лов нара Жвовумнаноцонии доязтнхчА ... 583 
Базовый интерфейс ЛакпоуаиинилооаноыыАисОл АННЫ 584 
Написание О@М-кода лс: ел ееулолачаяь ОБЬ ВПОТНОЗЧТОПЭНИИНОЕАООН... 586 
СОМ-классы на основе множественного наследования ........................, 587 
Инфраструктура ОМ. „4 еленьья ИНЛАБИЯЯД АВОЯ ЛУЛЕИФНЫОЙХ ... 588 
АСНУ ОВЕЯ СОМ... елок БОЗДЗАЯОЧИ РИ НОЙТОНОИЯАООЬ. .. 589 
АСНМЕХ. МВС СОМ.........-... ЧО АНИтЕовОвАО.6и Я О ЗЫ вНоиенеСИ 589 
Путеводитель по’ АТИ 11.511... коне нееноееекони киоске коне коем рее 590 
АВВ НН МИ. И МЕС, „ее ельнотньоо идее очнь ве риннно  оБре т о ИЕ 590 
АСОИ ААТЯНЯТТНА.ВАП.ММЫЗЖОНМЯЬ- = мМЕАЩе, 590 
ВОООИмоО РИТА ОВУЙ ...... еек ереси нони нике ирев аа ымьае ние. 590 
АЧСИсрр и АЧСИВ .............. АолонкестанчатнАлазонох.. зл.ВЕ 590 
АНЕаСЕТАИ АТРАСеВ .........., еее анала в урОИЗААННАЕЗИННКО 591 
У св Ко оо 591 
АБУ А У ИО Ре еее ее окнененеко с ЖЗ НОИОУИОСНЕЕ == 591 
АВЕРС: ГА ЩЕР В... ее иене сне коек ое ОВ аи 591 
Программирование клиента с помощью АТЕ ....... нение ити 591 
ШАбЛОНЬ ОНО Лоо Л... ие еее реткккрнких О РОИМУЙЕЕ += 591 
ВУПЯИООКАЗАТЕЛИ .... и. -.-ь. еее иеньск сек МО -ИЗИНИЕМЕРКОВ-КУУРУН О =. 595 
Наполнение указателей ИНТЕЛЛЕКТОМ»... иене ииньн нь лимит 594 
Применение зтац-указателей ........... еее РИ еб 2 595 


Уансуказацелии о ОМрабятьюзеЕмый АР ПЯСАТАЗЫНЕМ. „-.-.ееееененеанне 596 


ХМ Оглавление 
Я едебельс ЕЗАРИРИИООЕИЕЕИИНИЕЕООИИИВЕ 


атнуказателивАТЬюлини хизтииланоххояоаеинеатава лнаНОМенаяеХ... 597 
Нрограммированив серверав:АТИ......... залили ааа нь ночечавени новь ИЦ, 605 
АТВИСОМЕКладевискеные....... ЗохЯллолих низонойнй ненокалойом... 605 
Параметры АТТ-проекта. ..........:...-.... ЭНЫЯАЩЕЮаЛ ЗаНиБООНЖУНмМеныХ. .. 607 
Создание «классического» СОМ-класса *........1. аи. 608 
АЕ А ОЕ АСТА О ре 609 
Точки соединения и 1ЗарромЕ то! ............ ина нннн и, 611 
Маршалерсвободных потоковых. обои О ПЕЛОИЮ т Ими З9е 611 
Реализация класса $расез р средствами классической АТИ. .......... 1... .4н:.. 612 
Базоваяархитектур А идизтооа низонавазья зав ОРаБСИ, валемиииаезей 1... 613 
Предотвращение «распухания» У ........... инь, 614 
АГ-версия Шпкпоуп: ССотОБесВоо!Ех '......1. анна 615 
АИС р УИАВАЖОМ:. 618 
Космический корабль учится летать ................ МПО воем... 620 
Добавление методов в интерфейс .............. аи иаанницье, 622 
Двойственные интерфейсные оная оз биле С омеемаюнимияни засеки... 625 
АТОМА рав, +... дне рее иран в ТОМЕ М ДУХ 624 
Интерфаисы ЦИОПоци ао ЗОВИ ааВЯ 625 
Множественные двойственные интерфейсы .............. ани, 626 
Программирование с применением атрибутов ............. нии иьнан, 628 
Глава 26 АТЕ и элементы управления АсёуеХ 630 
Элементы управления АсцуеХиоо офис каазюаиниюу тие бо кивает инок дам 630 
Создание элементов управления с помощью А, ........... ини наньылн., 631 
Создание элементауправления ,.....;. у. лари ььи р ОО ООВЕЯ 2. 632 
Архитектура элемента управления на основе АТИ, .......... анна. 635 
Проектирование элемента управления ............... анали и нии нии нина 640 
Создание элемента управления на основе атрибутов ......... лилии ини. 669 
События элемента управления в АТ, с атрибутами .......... 1... 671 
Глава 27 Шаблоны ОЕ ОВ 672 
УболАвОЕ ОВО НОУТ, >. рр еазоввррорвовь р рзррьь АВЕ... 672 
ОСВОВыаРХИТеКТУВЫ ОПЕОВ, зреет ерор рено вр ЧАВО... 674 
ОсиовыархиткрыаслонововеО В: ов 674 
Архитектура шаблонов потребителя ОТЕ ОВ ............ ани нина, 675 
Архитектура шаблонов провайдера ОТЕРВ ............. ааа нининанинниининия 677 
боздание потребителя ОЕ РВ 2..1... ара оеБаотия выноса... 681 
Использование потребителя ОТЕЛВ......,......„..ельналиь ОКО ВИНА 685 
Создание провайдера ОГЕЮВсяодаузан отоныаятолкюни.засиск азия МО... 686 
Модификация кода провайдера. .............. а льиаь ники, МООООИИРТО ОЙ 692 
усоверщенствование провайдера .........;.. ол, ььь., МОЛЬ ЯЛО Ка... 694 
Программирование ОГЕ РВ на основе атрибутов ............ ини линннин, 694 
ЧАСТЬ 5 и 
СОЗДАНИЕ ПРИЛОЖЕНИИ ДЛЯ ИНТЕРНЕТА 699 
Глава 28 Основы Интернет-технологий 700 
ОбноваеИневне тан и лииоииилолих ПЯЭВМИВ В ВИЗОЮИНЕ, .. 701 
Сетевые протоколы и ихуровни .............. 1... иные, 701 
М ОКОЛЬ НЕЕ ее Аи ооо ЗА В ЧОН _ 702 
Протокол ОБР ....... енота О... 702 
Формат ГР-адреса и порядок байтов .................. ана, 703 
ПБотоКол ОВ Кии А енто или ох ВНОВО ›, 704 
Системадоменных имен ЭМ - ул илоиилелиии ПИВО ВОО, 706 
ПООИОВЕЕЕНИЕ РЕ ЭВА ооо ИС РАЕТАКО НГОЛАЕвЖ ЭМИЗНАОПЕН : , 708 


СФоневыоЕЕРя идолом слое. МПЭТРЕБИИ ЛЕО ЭняЗНомМНо 710 


Оглавление ХИ 


Ивзерневиинтрасетьле аа лав. нЕт, Ночным от... 710 
Саздание интрасети, ... иль нение вена аоелк вне еб ероеския СОАО 710 
АТЕЗИЛИЖАЙ А, еек ева вьа наи бъет, ПЗ РОЛЬ, . 710 
СЕТеВОС оборудование: . еее иеньь и: РОВ НАЕРИАЖЕ КЕРОСИН. 711 
Конфигурирование УЛпао\$ для работы в СЕТИ ........... ини не. 712 
Имена узлов интрасети: файл НО$Т5, ...:.. гони у си ньаеенненаа ПВА... 712 
Тестирование интрасети: утилита Р!п8 12... нини: 712 
Интрасеть на одном компьютере: адрес замыкания на себя 
ВИБОТОКОЛЬ ПОВ ИЕ ООС сев 712 
Программирование на основе У/1п$0СК ......... еее нина иначе. 713 
Синхронные и асинхронные программы ............. нение, 713 
УЛЬбоск-классы в МЕС соли а змевстава с ква 713 
Классьибловиряющжих сокетов сини иновови а овом онназновио 
Упрощенный НТТР=сервер,....,.....:.. оочееавииле змеи к слоем 720 
Удрощенный НТ'ЕРЕКЛИЕНТ .... енота. УР 
Создание \еЬ-сервера при помощи СНирВюсНп85о0сСКее ............ зе ееннениньние: 724 
Ограничения сервера Вх 84 ино мове: 724 
Архитектура сервера: ЕХаВа ... еее уенаеейные. 724 
Использование \/1п52-функции ТгапзтИЕЙе ......... нение тинннь 725 
Сборка и тестирование Вх манере. 726 
Создание \еБ-клиента с помощью СНирВюс® пэ5оскКее ........ еее енанннннннь 727 
УЛлЗОСК-КЛИеНТ Ва ее еее: а ван 7 
Поддержка прокси-серверов в Ех28а...... дней юононе Рави. У 
Тестирование УЛизоск-клиента Ех28а` ....... еее Нек 728 
ЗАВТЕ еее осень но беоне, РОЙ аиста 728 
Преимущества УЛиле перед \1750СК „ант лок несть нони дя 728 
МАШЕ КЛАССЫ Мо ее ке арОАеИт 729 
Функции обратного вызова'.... еее ваз СНА Чана 730 
Упрощенный УЛотпесклиент`........... Гзисегия онелаеть греч ваноЕ в Э 
Создание \/еБ-клиента при помощи УЛпте(-классов МЕС ............ нение: 732. 
У/пште-клиент №1: на основе СНирСоппесноп .......:..... ини ннненинннь, 732, 
чашееклисЕт Кохона основе ОБеПОКЕ ..... ее 733 
Асинхронные файловые моникеры еее ео 734 
оо о Со ие ВИТРИНА ЕЕ ТТ 734 
МЕС-классСАзупсМолщетЕ Це сосониелий кббливоеневтаамочо 734 
Использование класса САзупсМопщегЕЦе в программе ........... нение. 735 
Асинхронные файловые моникеры или программирование 
ономеныю. ХОТ анея ко ода ОИ сечу давней + 736 
Глава 29 Введение в упатс НТМЕ 737 
ОБыектная МОДЕЛЬ ОНТ М иена ере р оиааИеНЕМИ А Над 738 
МА МЕТ НТ МЕ ое Ро сео вегДАУЕЮ 741 
Нример Ех29а: МЕС и ОНТМЬЕ ........... елены а ООО 742, 
ИБимер Ех29Б: ОНТМЬи МЕС ..... ними иносрнан аа чнисеов Ча 742 
ВВИмер ЕС ОНТМ ИА... чз снамеюдаовну нажокаа ЭВНЗЬЗИ? 746 
Дополнительнаяинформация‘............. ео ьнь веер аа 748 
Глава 30 АТЬ Зегуег 749 
О И ее ОмИи 749 
Оснасткатиетенуонмавой 5егясе5 ..............., зидаюадев ааа в >> 750 
Е 2. уе ана 3 750 
О ИТ И Е ИИ ИУС > ЕЕ 752 
Регистрация подкточений ПЗ: аира рее пиреаОй т 952 
Ну опСНи АО О ОИ Ио ни ДИ 753 
Е И С ОВЕРЯ >... она вона Ре ны бана 755 
оз оон оО Е т Хе 754 


Простой запрос СЕТ, обрабатываемый Г5АР!Г-расширением .................... 754 


ХУШ Оглавление 


НОМ форме СЕ Вили РОТ п ооинеиины нак О а 754 
ОЕ ВЕ СРО, ВЫ... диана зоанли зы жиз аьау очи, МЕЗОВЕТТНБЕЗЩЫХ, 757 
О Е. с Ч В ЗУ 
Какоемсотозанимает ИТ, Зетуег. „ии миимотасвоааяо.. 757 
‘Архитектура Аи егускось белее уавоо и ономоснаильфнох.. 758 
ЭКНАРАЙЛЫН ЛУ 5, ааа ль ТОН фитоовони, подЕевнзыЫ, 759 
Пример Ех3Оа: еБ-сайт на основе АТГ, Зегуег ....... 1... или ии ьшинь, 763 
ЧАСТЬ 6 
МЕТИ ДАЛЬШЕ 767 
Глава 31 МюгозоН „МЕТ 768 
Компонентная модель в УИ о\! $... 0:00. ПО Дия 768 
Немного из'ИСТории КОмНоНентов”: ео оао инаанамочи ©... 768 
НА < 769 
ИЯ О ет ОМОН Чаво -(3ие ЭННЯ 770 
ООВ ОМ еее риси ЗОЖ ВОЗАЦОО иННЗУНИВеЬ 770 
о НД ИН. Я 
сотой апецаре Копите тие ЧН ое де 772 
И И К МВ С ВнИСЬЮА ... 772 
Вос допов тина као сое Аи ЛОПОНОй 2 БТИ ЭННЕ 774 
Ане ОАО ТАЗНААООВИИ И, 774 
Зоной Тапцане эренсанопе тик ночовыо-ыолосиу вижозАдОх 778 
И АО к еекИИ 779 
р оон НН ВР НОННА НОННА АННО НИ 781 
Всрее соптойТтаичаяе Копите оао ФАТЗУИУмМНЗЮ 782 
и ррем А ОВИНИИ , 784 
И ООН... 784 
сСовместиноствсо старыекодом” 5 ео ТИИяНЗаНИ с Нанна 785 
Глава 32 Управляемый С++ 787 
ито ЭЧУ ЗВОН ВЫчСТиЗНИя ИИ, 787 
ЧЕМ ИСО ЗОВ СН ооиттскексс ЧиННОм Эмаощни рано 788 
Е: кретин ее ЧАВИННОМЬ .. 790 
УвоанстЕЕ МЕТ управляемые НИ ам ЦОмОеровАл. Ва, 791 
Пример Ех32а: ОИ .-сборка на управляемом С++ ............... анала, 791 
Управляемое перечисление РаузОРТВе\ЖееК .............. нана: 796 
Управляемые структуры АМапазеУашеб асе и АМапазеСс$гас! ............ 796 
Управляемые интерфейсы 1АМапаредииег асе и ТРегзоп ............ анна, 796 
Управляемые классы РоСОМУР Зо_\агереуеорег и Вит ..................... 797 
НЯ АН Е о р ее, 797 
о О ОВ о Е НОНО ие 797 
Орлниессборки ооо чи нинтиицинсти АЖ МАЕ РР МАБСЗКА ЧЭМ 797 
Пример Ех32Ъ: управляемый клиентский ЕХЕ-модуль ......... ани ннннннньь, 798 
Обеспечение поддержки управляемого С++ ............ 1... нина ни нни ну, 801 
Глава 33 Программирование в \Мтаомиз Рогтз 
на управляемом С++ 803 
БАОКАС ИНО О ОЕ СЕТИ Пе 803 
а СУ ПИ С О ИР АИ 804 
И рее до о 804 
о оо ок а оо О бекон 805 
О еее дуги вродь рооовиошевч 808 
бработаОЕн Е Ро иа р о аиы 809 
Формирование и вывод изображения на экран ............... линии ннннни 809 


ИО Они 826 


Оглавление хх 


Глава 34 Программирование в А$Р.МЕТ на управляемом С++ 827 
Интернет каюилатфермаразработки ........ 1. ее 827 
Эветония:АЗВМЕТ ори одарен 828 
Вольер а вые лора ее романы нь ма 8230 
Мозель комнилении в. АЗРМЕГТ, неа она оба ааа 850 
ОВ В О ОС О О О О и 851 
СОВЕТ ОФАЙЬЕ о оеаейныя 832 
И ор ео понес ааеыие 855 
ЧТО ОЛУНИЛОСЬ АСНУ Х зу. алена ас ОНОСИиНЯ 839 
Конвейер обработки ТТ В-запросовь. икодес, думе повинна котоесяйАЫя 841 
ООО и оо ныа лен кое ра рае Ба о ной 841 
ао алое сер облет 841 
ооъектпирмонато “ПЕ НАНА ЗЕ оь Но ОУ 841 
Примере я3 45: создание НтТТРАМОДУЛЯ Тао он 841 
ОбъёкеНирНая ет” же. споров зови нидениия вии эмоца половом 844 
О-В се в ола 847 
УеБ-сервисы: на управляемом С++ лье зелье сорри ол ре © 848 
о ее оо ай ПооИд  оооаой уиие 849 
ВЫЗОВ Ь-МОТОДОвИ НАЯ АННЫ ИСИ а ра. В 849 
Глава 35 Программирование в АОО.МЕТ на управляемом С++ 851 
Управляемыеяровайдерье” ие ори све СеноСИНОт ЗОЯНИРОвЕСт ааЗвомя 851 
Пра ПОВ В Е лова ны ьмАььи 852 
РАБОТА с ПрОВАЙДеВами доступа к ДаННЫМ *.......:.... ИНН, 852 
Подключение базеданньюсолоы. си. лодке. 55 дов ЭНиЙ. ово замжД 852 
Витолиенивкомании МНос развиваются аспостманыс пыстро обучая 855 
Вызов хранимых процедур из объекта-команды ............. ле ннанннье я 856 
Применение объектов чтения для выборки данных ..........: нения 857 
Обработкабщибею и завхо энынсоки, убоя Эна ураас. чение 858 
Наборыданных в АБОМЕ усов лон нубы Аню БРОНЬ ВОЫ ЗО 858 
Применение адаптера для заполнения наборов данных ........................ 859 
Созданиенаборов данных в памяти... Геи ИИА 860 
Преобразование наборов данных в ХМГ--файЛы ............ нение ннньа 862 
Приложение А Функции карт сообщений в библиотеке МЕС 865 
Приложение Б Идентификация МЕС-классов во время 
выполнения и динамическое создание объектов 871 
Предметный указатель 877 


Об авторе 893 


Благодарности 


Писать этот раздел приятнее всего — работа над книгой практически завершена, 
и остается лишь поблагодарить всех, кто приложил свои силы, чтобы она стала 
реальностью. Имя автора выведено большими буквами на обложке, и поэтому о 
том огромном числе людей, которые приняли участие в создании книги, отдав ей 
массу своего времени и энергии, часто забывают. Так что я хочу поблагодарить 
этих людей. 

Я хочу сказать спасибо Сэнди Дастон (5апау Разюоп) и Теду Шеферду (Теа 
ЗБерВега) — это моя семья — за поддержку во время написания книги. 

Спасибо Дениз Банкаитис (Реп15е Вапка!$), которая выполняла в проекте 
функции редактора и постоянно напоминала мне о важности книги (ведь это один 
из ключевых справочников по программированию на С++ для .МЕТ), а также ко- 
ординировала деятельность команды, всем членам которой — отдельное спасибо: 

Джули Сяо (ое Х1ао) — за заботу по искоренению ошибок; 

Айне Ченг (а СБап?) — за то, что написанные мной предложения стали чи- 

табельными; 

Дэниэлу Берду (РамеЦе Ва) и Джулиане Олдос (]аНапа А!Чои5) — рецензен- 

там издательства, поддерживавшим проект и не позволившим ему сбиться с пути; 

Джоэлу Пенчоту (] ое! РапсвоГ) — за то, что графика в книге прекрасно смот- 

рится; 

Карлу Дицу (Сай 22) и Джине Кассилл (Ста Са$$Ш) — за создание макета 

книги и приведение ее в удобоваримый вид. 


Хотелось бы также поблагодарить сотрудников учебного центра ОеуеорМепог 
за организацию сообщества единомышленников и создание прекрасных условий 
обсуждения и изучения современных информационных технологий. Вы — самые 
лучшие. 


Введение 


Выход Мисгозой У15ща1 5саЧю „МЕТ (в частности, У15иа1 С++ МЕТ) подтвердил взя- 
тый компанией М1сгозой курс на Интернет-технологии, которые легли в основу 
архитектуры М1сгозой „МЕТ. Кроме поддержки инициативы „МЕТ, в У151а! С++ МЕТ 
есть полный набор средств повышения производительности труда программиста, 
в том числе уже знакомые вам Еай Апа Сопипие, ииеШ5$епзе, АмоСотр/еге и под- 
сказки по коду (соае ирз). В У15иа1 С++ .МЕТ также масса новых возможностей, таких 
как управляемый С++ для программирования приложений МЕТ, поддержка кода 
на основе атрибутов и более продуманная и теснее интегрированная среда раз- 
работки, которые ставят \154а1 С++ „МЕТ на более высокий уровень. Эта книга по- 
может вам не отстать от технологий, появившихся в \15а! С++ МЕТ. 


.МЕТ, МЕС и АТЁ 


Технологии в современном мире развиваются непостижимо быстро. Сначала ни 
у кого не было настольных компьютеров, в 80-х почти все обзавелись машинами 
под управлением М$-РО$, и, наконец, к середине 90-х компьютеры под управле- 
нием М!сгозой УЛпао\з заполонили мир. И, по-видимому, технологии сделают еще 
один виток. В конце 90-х ХеБ-сайты разрабатывались вручную, с использовани- 
ем «простого» языка НТМГ (НуремехЕ МагКир Гапеиаее), ССТ (Соттоп Саиеумау 
ИцеГасе), ОИ.-библиотек 15АР! (Ицегпее 5егуег Арр|саНоп Ргозгатиут® пиегасе), 
Таха и АЗР-страниц (Асйуе 5егуег Разез). В июле 2000 г. М1сгозой возвестила о на- 
мерении заменить все это технологией „МЕТ. 

Сейчас М!сгозой вовсю работает над .МЕТ. Пару лет назад для создания \еБ- 
сайта нужно было лишь установить сервер, приобрести ГР-адрес и «выложить» на 
сайт какую-то информацию. После этого сайт становился доступен всем — до- 
статочно было знать ОВТ-адрес. Коммерческие предприятия использовали \/еЬ для 
размещения данных, которые могли пригодиться клиентам. \еБ-среда также ока- 
залась ценным исследовательским инструментом и средством распространения 
информации. 

В ИТ-мире ближайшего будущего ЖеЬ будет играть первую скрипку. Однако 
ситуация изменится: до этого содержимое ЖеЬ-сайтов предназначалось пользо- 
вателям, теперь же с этой информацией будут работать другие компьютеры. То 
есть доступ к содержимому \/еБ-сайтов станет возможен из программ — благода- 
ря \еБ-сервисам. Согласно концепциям МЕТ ответственность за организацию 
многофункционального пользовательского интерфейса возлагается на сервер. 

В условиях эйфории относительно ЖеБ-сервисов и пользовательских интер- 
фейсов, поддерживаемых сервером, может показаться, что автономные приложе- 
ния и клиентские сценарии — прерогатива таких средств, как библиотека МЕС 
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(Мсгозой Еоипаайоп С!а$$ ГАБгагу), — окажутся за бортом истории. Однако вряд 
ли исчезнет потребность в полнофункциональном пользовательском интерфей- 
се. Многие полагали, что «персоналки» и распределенные технологии естествен- 
ным путем вытеснят мейнфреймы и миникомпьютеры, а оказалось, что ПК и рас- 
пределенные вычисления лишь дополнили общую картину ИТ-мира. Принципы 
У’еБ-сервисов в .МЕТ и поддерживаемые сервером многофункциональные пользо- 
вательские интерфейсы стали еще одним вариантом, доступным разработчикам. 
Полнофункциональные пользовательские интерфейсы никуда не уйдут из боль- 
шинства приложений, которые прекрасно уживутся с другими приложениями с 
другого типа интерфейсами (в том числе поддерживаемыми сервером \еБ-интер- 
фейсы). 

МЕС — зрелый, хорошо изученный инструмент, обеспеченный обширной под- 
держкой сторонних компаний. Какое-то время эта библиотека останется одним 
из самых производительных способов создания полнофункциональных автоном- 
ных приложений. Львиная доля данной книги посвящена приложениям «в стиле 
МЕС», но мы расскажем и о УЛп4о\з$ Еогпл$ — технологии создания интерфейсов 
клиентских приложений в .МЕТ. 

А что будет с СОМ? Эта технология позволила решить массу проблем органи- 
зации распределенных вычислений, но у нее есть ряд серьезных недостатков, как 
правило, связанных с поддержкой версий и информации о типах. Работа МЕТ ос- 
нована на общеязыковой среде исполнения, или СГВ (Соттоп Гаприаре Кипите). 
Она берет на себя функции СОМ по обеспечению совместимости. О .МЕТ и СГВ- 
среде подробно рассказывается в части 6. 

СОМ и СГВ-среда основаны на различных компонентных архитектурах, и все 
же Мсгозой позаботилась о механизмах «мирного сосуществования» этих техно- 
логий. Обычно удается без проблем обеспечить совместимость СОМ и СГВ. Ма- 
ловероятно, что в мире .МЕТ вы станете использовать СОМ в качестве компонен- 
тной архитектуры, однако вряд ли откажетесь от АТГ. (Асйуе Тетр!ие Бгагу) 
5егуег — высокопроизводительного инструмента создания \еБ-сайтов. 

В этом издании мы «освежили» описания АТТ, и МЕС, так как они все еще оста- 
ются действенными инструментами разработки. Более того, вы узнаете, как ис- 
пользовать уже созданный код при переходе на .МЕТ. 


Управляемый С++ и С# 


Вместе с платформой МЕТ компания М1сгозой представила новый язык — С# (про- 
износится: «си шарп»). Он похож на С++, и в нем такой же основанный на фигур- 
ных скобках синтаксис. В С# сняты проблемы, характерные для С++ (в частности, 
управление указателям), но сохранены многие достоинства С++ (в частности, 
виртуальные функции). Кстати, компилятор С# генерирует управляемый код, спо- 
собный работать в СГВ-среде. 

Понятно, что весь мир не перейдет на С# в один день — слишком много кода 
написано на С++, да и разработчикам потребуется время, чтобы привыкнуть к С#. 
Помимо прочего, в МЕТ представлены новые дополнения к С++ (Мапазеа Ехеп$10п$ 
Гог С++), или управляемый С++, программы на котором исполняет СГВ-среда. Управ- 
ляемый С++ позволит быстро модернизировать унаследованный код на С++ для 
работы в СГВ-среде. Преобразование «обычного» кода на С++ в управляемый о3з- 
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начает щедрое его «сдабривание» определенными ключевыми словами. В конеч- 
ном итоге по завершении работы компилятора тексты на С# и на управляемом 
С++ преобразуются в одинаковый исполняемый код. В мире .МЕТ вы скорее всего 
будете создавать новые программы на С#, а управляемый С++ применять для пре- 
образования своего старого кода в совместимый с МЕТ. 


.МЕТ и платформа Чауа 


В последние годы вырос интерес к языку программирования ]ауа и платформе 
разработки на ]ауа, которые Интернет-разработчики полюбили за средства рас- 
пространения пользовательского интерфейса (с помощью ]ауа-апплетов) и под- 
держку разработки корпоративных приложений средствами ]ауа Егиегризе Е@юп. 
Теперь лучшей платформой для разработки Интернет-приложений стала платформа 
„МЕТ. В отличие от ]ауа, где требуется писать код только на этом языке, МЕТ по- 
зволяет для получения одинакового исполняемого кода применять разные язы- 
ки. Для своих программ вы вправе использовать «обычный» и управляемый С++ 
(им посвящена настоящая книга), \У154а1 Ваз1с МЕТ, С# или любой другой язык, под- 
держиваемый „МЕТ. Исходный текст преобразуется в код на промежуточном язы- 
ке, который во время исполнения трансформируется в машинные команды. В пе- 
риод выполнения МЕТ управляет исполнением кода, обеспечивая такие преиму- 
щества, как сборка мусора и повышенная безопасность кода. 


Кому адресована эта книга 


\У15иа! С++ МЕТ с ее мощными средствами разработки приложений и поддержкой 
„МЕТ предназначена для профессиональных программистов, и эта книга — тоже 
для них. Мы считаем, что вы достаточно хорошо знаете С++ и можете написать 
оператор #, не обращаясь к справочнику. Мы также предполагаем, что у вас есть 
некоторый опыт работы на С++ — по крайней мере вы прошли некоторый курс 
обучения или прочитали какую-нибудь книгу о нем, хотя, может быть, и не писа- 
ли очень больших программ: Изучение С++ можно сравнить с изучением фран- 
цузского. Даже если вы учили его в школе, вы не сможете свободно говорить на 
нем, пока не поедете во Францию и не пообщаетесь с носителями языка. 

Мастера У15иа! С++ экономят время и повышают корректность кода, но про- 
граммист должен понимать, что за код они генерируют, и — что самое важное — 
разбираться в структуре библиотек МЕС и АП, и внутренних механизмах работы 
УЛпао\з и .МЕТ. Однако мы не считаем, что вы знакомы с программированием 
для УЛпао\з и МЕТ. Мы уверены, что опытные программисты на С++ могут изу- 
чать работу с \/Лт4о\$ как посредством МЕС, так и .МЕТ. Знание С++ важнее зна- 
ния АР! \/1п32. Тем не менее мы полагаем, что читатель умеет работать с \Лпо\з 
и У/п49о\5-приложениями. 

Что, если у вас уже есть опыт работы с АР! УЛп32 или с библиотекой МЕС? В этой 
книге найдется кое-что интересное и для вас. Вы узнаете о новых возможностях, 
таких как интерфейс со многими окнами верхнего уровня (Мире Тор-Геуе! 
Ицегасе, МТП) и мастера У15иа1 С++ МЕТ. Если вы еще не знакомы с моделью СОМ 
(Сотропепе ОБес! Мо4е|), эта книга содержит некоторые важные теоретические 
сведения, с которых начнется ваше знакомство с элементами управления АсНуех. 
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Вы также познакомитесь с АТ, 5егуег и шаблонами ОГЕ ОВ. Мы обсудим програм- 
мирование на С++ для Интернета (в том числе Рупапис НТМП). Наконец, мы рас- 
скажем о некоторых скрытых особенностях управляемого С++. 


Что не вошло в книгу 


В одной книге невозможно рассмотреть все стороны программирования для УЛ ш- 
Чоу$ и МЕТ. Мы исключили темы, требующие специализированных аппаратных 
или программных средств, такие как МАРТ, ТАР! и работа с коммуникационными 
портами. Мы рассмотрим элементы управления АсНуУеХ и написание АсНуеХ-эле- 
ментов с помощью АТГ, но оставим подробный рассказ об АсиуеХ Адаму Деннигу 
(АЧат Репп!?) и его книге «АсНуеХ Сопиго!5 шяае Оць. (Мсгозой Ргезз, 1997). Мы 
познакомим вас с основами управления памятью в 52-разрядных системах, тео- 
рии РИ. и приемами многопоточного программирования, но для серьезно изу- 
чения этих тем вам потребуется книга Джеффри Рихтера ()ейгеу Еасшег) «Ргоэгат- 
пит АррИисайопз Гог Мсгозой УЛпоууз» (Масгозой Ргезз, 1997) (Рихтер Дж. УЛпао\ 
для профессионалов: создание эффективных \/1п32-приложений с учетом специ- 
фики 64-разрядной версии УЛпдо\уз. М.: «Русская Редакция» и «Питер», 2001). Другая 
полезная книга — «МЕС Ицегпа15» Джорджа Шеферда (Сеогое ЗверВега) и Скотта 
Уингоу (5с0Е УЛпзо) (АЯ 915оп-Жез$1еу, 1996). Мы расскажем об основах .МЕТ, дета- 
ли программирования для этой платформы см. в книге Джеффри Рихтера «АррНеа 
Мисгозой „МЕТ Егатеууогк Ргозгатили1е» (Мсгозой Ргезз, 2002) (Рихтер Дж. Про- 
граммирование на платформе М5 МЕТ ЕВАМЕХОВК. М.: «Русская Редакция», 2002). 


Как пользоваться книгой 


В начале работы с У!15иа! С++ МЕТ книгу лучше читать последовательно. Затем ее 
можно использовать как справочник. Из-за тесной взаимосвязи между большин- 
ством компонентов каркаса приложений невозможно посвятить каждому аспек- 
ту отдельную главу, поэтому книгу, безусловно, нельзя рассматривать как энцик- 
лопедию. Читая ее, полезно иметь под рукой интерактивную справочную систе- 
му У151а1 С++ .МЕТ для просмотра информации о классах и функциях-членах. 

Если вы имеете опыт работы с предыдущими версиями У1зиа! С++, просмот- 
рите часть 1, чтобы получить представление о новых возможностях. Затем про- 
пустите первые основы МЕС в части 2, но прочитайте главы, где обсуждаются де- 
тали каркаса. Обязательно прочитайте часть 6, посвященную МЕТ. Большинство 
программистов движется именно в этом направлении, а У15иа! С++ .МЕТ полнос- 
тью поддерживает модель программирования в .МЕТ. 


Структура книги 


Как видно из оглавления, книга состоит из шести частей и двух приложений. 


Часть1: Основные сведения о МИптдо\мз, Миа! С++ .МЕТ 
и каркасе разработки приложений 


В этой части мы стремились поддерживать баланс между теорией и практикой. 
После беглого обзора \1п32 и компонентов \!150а1 С++ МЕТ вы кратко ознакоми- 
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тесь с каркасом приложения МЕС и архитектурой «документ-вид». При помощи 
классов библиотеки МЕС вы создадите простую программу «НеПо, уог!9Ъ, насчи- 
тывающую всего 30 строк текста. 


Часть 2: Основы МЕС 


В документации по МЕС все элементы каркаса приложения рассмотрены после- 
довательно в предположении, что вы знакомы с оригинальным АР] \УЛпдоу’з. Вторая 
часть книги посвящена только одному важному компоненту каркаса приложения — 
виду, или представлению (\1е\), которое на самом деле является окном. Здесь вы 
узнаете то, что и так известно опытному программисту для УЛп4о\з, но здесь эта 
тема представлена в контексте С++ и классов библиотеки МЕС. Инструменты У151а! 
С++ МЕТ позволят нам избавиться от большей части рутинного кодирования, 
с которым приходилось мириться программистам на «заре» УЛт4о\5. 

Во этой части затронуто много тем, в том числе программирование графики 
с использованием растровых изображений, обмен данными в диалоговом окне, 
использование элементов управления Аснуех, 32-разрядное управление памятью 
и многопоточное программирование. Упражнения помогут написать довольно 
сложные программы для \У/Л1п9о\$, не обращаясь к расширенным средствам кар- 
каса приложения. 


Часть 3: Архитектура «документ-вид» в МЕС 


В этой части рассматривается «настоящее» программирования с использованием 
МЕС — в архитектуре «документ-вид». Вы узнаете, что такое документ (нечто бо- 
лее абстрактное, чем документ в текстовом процессоре) и как подключить его к 
представлению, с которым вы познакомились в части 2. Написав класс докумен- 
та, вы будете поражены, насколько библиотека МЕС упрощает программирование 
файлового ввода/вывода и вывода на печать. 

Вы также узнаете об обработке командных сообщений, панелях инструментов 
и состояния, разделяемых окнах-рамках и контекстно-зависимой справке. Здесь 
также рассмотрены виды интерфейсов в УЛп4о\5-приложениях: однодокумент- 
ный (шее Доситепи ИцегЁасе, $0), многодокументный (Мире РоситепЕ Иие!- 
асе, МО!) и интерфейс на основе многих окон верхнего уровня (Мире Тор-Геуе! 
УЛпао\з ИцегЁасе, МТП). Последний является стандартом интерфейса современ- 
ных УЛпао\’з-приложений, например М!сгозой Хюга. 

Здесь же обсуждается, как с помощью МЕС написать динамически подключае- 
мые библиотеки (Бупапис пк ганез, ОГ). Вы поймете различие между обыч- 
ной ОРЦ. и РИ-расширением. 


Часть 4: СОМ, АщотанНоп, Ас#\еХ и ОЁЕ 


СОМ заслуживает нескольких книг. Здесь вы познакомитесь с основами теории 
СОМ с точки зрения МЕС. Затем речь пойдет об АмотаНноп — связующем звене 
между С++ и УВА (\15иа1 Ваз1с юг АррИсайопз). Вы познакомитесь с унифициро- 
ванным обменом данными (ОпИогт Оаёа Тгап$Еег) и основами составных доку- 
ментов и внедренных объектов. В этой части также рассмотрена поддержка ОТЕ 
ОВ в классах библиотеки АТГ. 
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Часть 5: Создание приложений для Интернета 


Эта часть начинается с технического введения в Интернет, в котором рассматри- 
ваются протокол ТСРЛР и интерфейсы программирования для Интернета. Вы 
узнаете, как создавать серверы средствами АГП, 5егуег и как программировать с 
использованием Рупапус НТМГ. 


Часть 6: .МЕТ и дальше 


Разработка приложений для Интернета больше не ограничивается созданием \Ь- 
сайтов, предназначенных для простого просмотра, — нужно создавать \/еЬ-сай- 
ты, доступ к которым возможен из программ. Все базовые средства связи уже су- 
ществовали, но до появления ХМГ, не удавалось достичь согласия относительно 
передачи запросов методов через Интернет. Платформа „МЕТ является прорывом 
по крайней мере в двух отношениях: в области \еБ-сервисов и обслуживаемого 
сервером пользовательского интерфейса. Она обеспечивает полную поддержку этих 
технологий и предоставляет новый метод создания клиентских пользовательских 
интерфейсов — на основе \Иш4о\/з Еог!п5. В этой части объясняется, что собой 
представляет платформа .МЕТ и что вы можете делать с ее помощью. Здесь есть 
главы, посвященные СГК-среде и управляемому коду, а также программированию 
управляемых компонентов средствами АЗРМЕТ и АРО.МЕТ. 


Приложения 


Приложение А «Функции карты сообщений в библиотеке МЕС» содержит список 
макросов карты сообщений и прототипов соответствующих им функций-обряа- 
ботчиков. Обычно код таблицы автоматически генерируется мастерами, доступ- 
ными в окне С1!а5$ Меу,, но иногда его приходится вводить вручную. 

В приложении Б «Идентификация МЕС-классов во время выполнения и дина- 
мическое создание объектов» приведено описание системы информации о клас- 
сах периода выполнения и динамического создания объектов МЕС. Эта система 
существует независимо от КТТ! (гапите 1уре шЮгтаНоп) — средства, описанно- 
го в стандарте АМЗ1 С++. 


\Мп32 или \ММт16? 


УЛпао\ 3.1 все еще встречается на некоторых старых компьютерах. Однако нет 
особого смысла тратить средства и время на создание новых программ для уста- 
ревших технологий. Это, 6-е, издание книги посвящено 32-разрядному програм- 
мированию для М!сгозой УЛпао\ 98 /Ме и УЛпао\/5 МТ/2000/ХР с использованием 
АР1 \Лп32. Если вам действительно нужно писать 16-разрядные программы, оты- 
щите второе издание. 


Требования к системе 


Для работы с этой книгой требуется установленная копия У15иа1 С++ .МЕТ или У15иа! 
Зтиаю МЕТ. Любой компьютер, удовлетворяющий минимальным требованиям для 
установки \151а| С++ МЕТ, подойдет для работы с примерами. Заметим, что в 
ОС УЛпаоу$ ХР Ноте ЕаШоп и УЛпао\$ МТ 4.0 нельзя разместить \еБ-приложе- 
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ния АЗРМЕТ на каркасе МЕТ ЕгаглеуогК. Такие приложения можно собирать на 
указанных системах, но развертывать их придется на более подходящей ОС. 


Примеры программ 
на прилагаемом компакт-диске 


Компакт-диск содержит исходные тексты всех примеров программ, а также не- 
которые вспомогательные материалы. Чтобы работать с файлами на компакт-диске, 
вставьге его в дисковод и выберите нужную команду из меню появившегося окна. 
Если автозапуск компакт-дисков на компьютере отключен, окно с меню не откро- 
ется, и вам придется запустить файл 5апСО.ехе в корневом каталоге диска. Для 
установки файлов с примерами требуется примерно 60 Мб свободного простран- 
ства на жестком диске. При выполнении программ-примеров настоятельно реко- 
мендуем сверяться с текстом книги. 

Об обычной программе на С, использующей АР! УЛ п9оууз, все скажут ее ис- 
ходные тексты. При использовании каркаса приложения библиотеки МЕС не все 
так просто. Значительную часть кода С++ генерирует мастер МЕС АррИсаноп УЛгага, 
а ресурсы порождаются соответствующими редакторами ресурсов. Примеры в 
начальных главах содержат пошаговые инструкции по использованию указанных 
инструментов для генерации и редактирования исходных файлов — вводить код 
вручную практически не придется. Для примеров из глав середины книги исполь- 
зуйте тексты с компакт-диска, но просмотрите последовательность шагов созда- 
ния программы, чтобы понять роль редакторов ресурсов и мастеров. В последних 
главах исходные тексты примеров приведены не полностью. При изучении этих 
примеров потребуется обратиться к примерам с компакт-диска. 

Кроме файлов примеров, на компакт-диске хранятся две электронные версии 
книги: автономная и интегрируемая в справочную систему У15ча1 5 ю. 


Дополнительные библиотеки \Мтдом/$ Рогт$ 


Одна из самых привлекательных особенностей, «продававшая» МЕС на протяже- 
нии 90-х, — библиотеки классов для расширения каркаса приложений. С появле- 
нием УЛпао\$ Еогт$ приходится следить за выходящими библиотеками-расши- 
рениями. 

МЕС и ее расширения ограничены языком С++, однако СГВ-среда в .МЕТ по- 
зволяет использовать самые разнообразные синтаксисы для написания приложений 
на основе УЛа4Чо\з Еогипз, в том числе С#, \15иа1 Ваз1с МЕТ и управляемый С++. 
Компания бупсва$1юп из города Кэри (Северная Каролина) создала набор инстру- 
ментов, облегчающих программирование для МЕТ. Набор Еззепиа! бийе содержит 
компоненты, которые позволят сделать ваши приложения \УЛпао\з Еогил$ более 
надежными и совершенными. Полнофункциональную 15-дневную пробную вер- 
сию Еззеп{а! бице, а также интерактивное приложение Ицегасйуе 5по\усазе, де- 
монстрирующее некоторые компоненты 5упс#а$1от в действии, можно скачать 
с сайта РИр://Иризупсияюп.сот. Компоненты работают в СГК-среде, поэтому их 
можно использовать в программах на управляемом С++, а также на С# и \1$иа1 
Ва$1с .МЕТ. 
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Поддержка 


Мы стремились избежать ошибок в книге и на прилагаемом к ней компакт-диске. 
Исправления к данной книге М!сгозой Рге$$ предоставляет по адресу: РИр//илрилтис- 
гозой.сот/тзртез 5 ирроти. 

База знаний М!сгозой Ргез$ Кло\Меаве Вазе доступна напрямую на \еБ-стра- 
нице рир://шишлистозой.сот/тзртезбирротизеатгсв.азр. 

Если у вас есть комментарии или вопросы, ответов на которые не удалось найти 
в базе Мсгозой Ргезз Кпо\еаэе Вазе, направляйте их в М1сгозой Ргезз по обыч- 
ной или электронной почте: 

М1сгозой Ргез$ 

Ай: Ргозгатилт уиь М1сгозой У15иа! С++ МЕТ ЕЧЙог 

Опе Мисгозой ау 

Ведтопа. А 98052-6399 

М5РИМРОТ@МСВО$ОЕТ.СОМ 

Техническая поддержка по указанным почтовым адресам не предоставляется. 
Подробную информацию о технической поддержке конкретных программных 
продуктов М!сгозой см. на \еБ-узле компании по адресу рир./ирроплистозой.сот. 


ЧАСТЬ ь 


ОСНОВНЫЕ СВЕДЕНИЯ 
О МММРОМ/$, УЗЧАЕ С++ 
МЕТИ КАРКАСЕ 
РАЗРАБОТКИ _ 
ПРИЛОЖЕНИИ 


ГЛАВА 


Мсгозой МИ/паом$ 
и Мзиа! С++ .МЕТ 


В начале 90-х годов борьба шла за «настольные» операционные системы, и на 
сегодняшний день она завершилась — М!сгозой УЛп9о\$ царствует на подавляю- 
щем большинстве персональных компьютеров. В этой главе мы обсудим низко- 
уровневую модель программирования в УЛп4о%$ (и в \/1п32, в частности) и уви- 
дим, как взаимодействуют компоненты У15иа1 С++ МЕТ при создании прикладной 
программы. Попутно вы узнаете кое-что новое и о УЛп4оу. 


Модель программирования в МИптдо\м$ 


Программирование в УЛп4о\$ отличается от старомодного стиля, ориентирован- 
ного на обработку последовательностей команд или запросов. Давайте разберемся 
в основах самой \/ш4оууз. За точку отсчета возьмем хорошо известную М5-О2О$5. 
Даже если вы сейчас и не пишете для М$-2О$, такая модель программирования 
вам скорее всего знакома. 


Обработка сообщений 


В М$-РО$-программе на С обязательно имеется функция тат. ОС вызывает ее при 
запуске программы, и с этого момента вы по сути можете делать что угодно. Если 
программе надо узнать, какие клавиши нажаты на клавиатуре, или как-то иначе 
задействовать сервисы ОС, она вызывает соответствующие функции, например 
зесраг, или обращается к более специализированной библиотеке функций, опе- 
рирующих с символами. 

В \Мпао\$ же система при запуске программы вызывает функцию ИмМат. 
В любом приложении должна присутствовать эта функция, на которую возлага- 
ется ряд специфических задач. И важнейшая — создание основного окна програм- 
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мы; у которого должен быть свой код обработки сообщений, поступающих от ОС. 
Существенное различие между М5-РО5- и УЛпао\5-программой состоит в спо- 
собе получения введенных пользователем данных: первая обращается прямо к ОС, 
а второй нужны поступающие от ОС сообщения. 


Примечание Многие среды разработки для УЛп4о\$, включая М1сгозой У15ча1 
С++ .МЕТ с библиотекой классов М1сгозой ЕочпааНоп С!а$$ (МЕС) ГАБгагу 
7.0, упрощают программирование, скрывая функцию тМат и струк- 
турируя процесс обработки сообщений. Библиотека МЕС позволяет обой- 
тись без написания функции мМат, но важно понимать, как взаимо- 
действуют ОС и ваша программа. 


Большинство сообщений в У/пао\$ строго определено и относится ко всем 
программам. Так, сообщение ИМ _СКЕАТЕ передается при создании окна, М _ГВОТ- 
ТОМРО\УМ — при нажатии левой кнопки мыши, М _СНАК — при вводе символа, а 
УМ _СГОЗЕ — при закрытии окна пользователем. У всех сообщений есть два 32- 
разрядных параметра, передающих такие сведения, как координаты курсора, код 
нажатой клавиши и т. п. Сообщения группы УМ СОММАЮР отправляются соответ- 
ствующему окну в ответ на выбор пользователем команд в меню, щелчки кнопок 
диалоговых окон и т. п. Параметры командных сообщений зависят от структуры 
меню конкретного окна. Кроме предопределенных сообщений, программист впра- 
ве определять свои, так называемые пользовательские сообщения, которые позво- 
лено направлять в любое окно. Из-за возможности создания таких сообщений С++ 
становится слегка похожим на ЗтаШа!К. 

Не ломайте пока голову над тем, как «увязываются» сообщения и программный 
код. За это отвечает каркас приложения (аррИйсайоп йате\уогК). Однако обработка 
УЛпао\/з-сообщений накладывает на структуру программ весьма жесткие ограни- 
чения. Не пытайтесь выстраивать программы для \Лп4о\$ по аналогии с М$-2О$. 
Изучите примеры этой книги и приготовьтесь начать все сначала. 


Интерфейс графического устройства 


Многие программы М$-РО$ записывали данные прямо в видеопамять и порт прин- 
тера. Недостаток этого метода в том, что разработчику приходилось создавать 
отдельные драйверы для каждой из множества моделей видеоплат и принтеров. 
В \Лп90%5 предусмотрен особый слой абстрагирования от оборудования — ин- 
терфейс графического устройства (Стар с$ Ремсе ицмегасе, СПП. Драйверы ви- 
деокарт и принтеров предоставляет сама \Лп4о\$, благодаря чему программе не 
надо «знать», какие видеоплата и принтер подключены к системе. Вместо обра- 
щения к оборудованию, программа вызывает СП!-функции, ссылающиеся на оп- 
ределенную структуру данных — контекст устройства (4е\1се сошехо. \Лт4о\$ 
сопоставляет структуру контекста устройства физическому устройству и выдает 
соответствующие команды ввода/вывода. СОГ обеспечивает почти такую же ско- 
рость, как и прямой доступ к видеопамяти, и позволяет нескольким \Лпдо%\з-про- 
граммам одновременно работать с дисплеем. 

Чуть далее мы познакомимся с СП]. Как вы, наверное, догадались, это следу- 
ющая версия СП1. Сервисы СО!+ предоставляются через определенный набор 
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классов С++ на управляемом языке, т. е. как код, выполняемый общеязыковой средой 
исполнения (Соттоп Гапзиаре КипИте, СГВ). В СП+ есть ряд функций, которых 
нет в «классическом» СПУ, в том числе градиентные кисти, кардинальные сплай- 
ны, независимые объекты-пути, масштабируемые области, альфа-сопряжение и 
поддержка множества форматов изображений. 


Программирование, ориентированное на ресурсы 


В М5-2О5 вы определяли данные при помощи инициализирующих констант либо 
считывания из специальных файлов. В \ЛпЧо\у$ же данные размещаются в файле 
ресурсов, представляемых в нескольких стандартных форматах. При генерации 
исполняемой программы компоновщик (Нпкег) комбинирует двоичные файлы 
ресурсов с кодом, полученным на выходе компилятора С++. Файлы ресурсов со- 
держат растровые изображения, или битовые карты, (Ы!арз), значки (1соп5), 
определения меню, описания структуры диалоговых окон и строки. Они могут 
хранить даже описания особых форматов ресурсов, определенных программистом. 

Программа редактируется в текстовом редакторе, но ресурсы обычно редак- 
тируют, применяя инструменты, обеспечивающие режим \/УУЗУ/УС (Х/Вае Уои Зее 
15 У/Ваг Уои Се! — «что видишь, то и получишь»). Так, при разметке структуры 
диалогового окна отдельные се элементы выбирают из набора значков — палитры 
элементов управления (сопио! раеце) — нужные элементы (кнопки, списки и пр.) 
и с помощью мыши размещают на форме и подгоняют по размеру. Графический 
редактор У1зиа! С++ „МЕТ позволяет эффективно редактировать ресурсы стандар- 
тных форматов. 


Управление памятью 


В каждой последующей версии Х/Лт4о\$ управление памятью становится проще. 
Если вы уже наслушались леденящих душу историй о блокирующих описателях 
памяти (Бапаез), переходах (ипК$) и прочих ужасах, не паникуйте: все это в 
прошлом. Сегодня вы просто выделяете память, а об остальном заботится УлаЧо\. 
Современные способы управления памятью в \/1132 (в частности, виртуальную 
память и проецируемые в память файлы) мы обсудим в главе 10. 


Динамически подключаемые библиотеки 


В среде М5-2О$5 все объектные модули программы связываются статически на 
стадии компоновки. УЛп4о\5 разрешает динамическое связывание, т.е. загрузку 
и подключение к программе специальных библиотек в период исполнения. К одной 
и той же динамически подключаемой библиотеке (Рупапис-ШпК ТАЬгагу, ОШ.) могут 
обращаться сразу несколько программ, что экономит память и дисковое простран- 
ство. Кроме того, динамическое подключение позволяет создавать модульные 
программы, так как ОИ.-модули компилируются и тестируются отдельно. 
Изначально ОИ, разрабатывались в расчете на язык С, а С++ привнес в этот 
процесс кое-какие сложности. Впрочем, разработчики МЕС сумели скомпоновать 
все классы каркаса приложений в несколько законченных ОИ.. Это значит, что 
упомянутые классы можно подключать к приложению как статически, так и ди- 


ГЛАВА 1  МсгозоН \\пдо\м$ и Миа! С++ .МЕТ 9 


намически. Кроме того, вы вправе создавать свои РИ.-модули расширения, пост- 
роенные на основе ОИ.-модулей библиотеки МЕС. Обо всем этом см. главу 22. 


Интерфейс прикладного программирования \/т32 


На заре УЛп4о\5 программисты писали приложения на С в расчете на интерфейс 
прикладного программирования (АррИсаНоп Ргоогатииае Шиегасе, АРГ) ХЛо16. 
Сейчас для \/1п16 пишут немногие — большинство работает с \/т32. Основное 
различие между \/1016-функциями и их \Х/Лп32-эквивалентами — в расширении 
представления ‘параметров с 16 до 32 разрядов. Поэтому, несмотря на постоян- 
ную эволюцию \/1п 90%; АР, программисты оказались в значительной степени изо- 
лированы от различий в АР, так как они создают приложения в соответствии со 
стандартом МЕС, поддерживающим как 116, так и \/132. 


Компоненты \1зиа! С++ .МЕТ 


Мсгозой У15иа! С++ МЕТ объединяет две законченные системы разработки УЛ шт- 
4о\5-приложений. Можно создавать \/таом$-программы на языке С, используя 
только \/т32 АРТ. Программирование в \У/Лп52 на С описано в книге Чарльза Пет- 
цольда (Свашез Рего!а) «Ргоргатимте УЛп оу» (Мсгозой Ргезз, 1996). [В Мсгозой 
Ргеб5 вышла его новая книга — «Ргоэтатимае Масгозой УЛп4оу$ ми С#» («Про- 
граммирование для М5 УЛп4о\$ на С#», «Русская Редакция», М., 2002 г.), — где рас- 
сказывается о программировании с применением С# и УЛпао\%$ Еогил$. Програм- 
мирование в УЛп4оу$ с использованием УЛп4о\з Еогпл$ и С++ мы тоже обсудим.] 
Заметно облегчают работу по низкоуровневому \/1132-программированию мно- 
гие инструменты У15ща! С++ МЕТ, в том числе редакторы ресурсов. Для ускорения 
разработки УЛтао\-программ можно воспользоваться и библиотеками каркаса 
приложений, такими как МЕС и УЛпао\$ Еогт$. 

Наконец, У154а! С++ .МЕТ содержит библиотеку шаблонов АсИуеХ (АсйуеХ 
Тегар!а(е ТаБгагу, АТГ), позволяющую разрабатывать элементы управления АсНуУех. 
Программирование в АТ! не сводится к программированию ни в \/1п32, ни в МЕС — 
оно очень сложно и заслуживает отдельной книги. И все же мы поговорим об АТГ- 
разработке, которая больше подходит для программирования высокопроизводи- 
тельных компонентов в среде ЖеБ-серверов. 

Эта книга — о программировании на С++ с использованием каркаса приложе- 
ний — библиотеки МЕС, составляющей часть У150а! С++ МЕТ. Вы будете применять 
классы С++, описанные в документах библиотеки М!сгозой Еоип4аНоп С1а$$ ГАБгагу 
ВеЕегепсе, а также специальные инструменты \150а1 С++ МЕТ для библиотеки МЕС, 
в частности, МЕС АррИсаНоп У/12агА и С1а$$ У1еу”. 


Примечание Работа с МЕС-библиотекой не лишает программиста возможно- 
сти применять функции \/1п32. На самом деле в программах на основе 
этой библиотеки почти всегда придется напрямую вызывать \1052-функ- 
ции. 


Прежде чем вы возьметесь за свое первое приложение, мы вкратце опишем 
компоненты У15ща| С++ МЕТ — это поможет вам понять, с чем придется иметь дело. 
Рис. 1-1 иллюстрирует процесс создания программ в У15а! С++ .МЕТ. 


2—2064 
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Рис. 1-1. Создание программы в Уби С++ МЕТ с применением МЕС 


Мсгозой \зиа! С++ „МЕТ и процесс сборки программ 


У1зиа! С++ МЕТ является частью У15ча1 $ ю .МЕТ — комплекта средств разработ- 
ки. Интегрированную среду разработки (Имезгаиеа ОеуеюртепЕ Епугоптепе, ШЕ) 
\У15иа! С++ .МЕТ используют и другие средства разработки, например Мсгозой ]++. 
Эта среда начала свой долгий путь с У15иа! \/’огКБепсв — среды, основанной на 
Ошскс юг \Ишаоуз. Теперь в ней есть стыкуемые окна (4оск те улп9о\5), кон- 
фигурируемые панели инструментов (сопйригаЫе {1оо!Багз) и настраиваемый 
редактор (сиопилаЫе еайог), способный исполнять макросы. Встроенная спра- 
вочная система, интегрированная с программой просмотра библиотеки М!сго5ой 
Реуе!орег Мегмогк (МОМ), теперь работает по принципу \/еЬ-браузера (рис. 1-2). 

Если вы работали с прежними версиями У15иа1 С++ МЕТ, то понимаете, как 
функционирует У15иа! С++ .МЕТ (хотя некоторые меню и поменялись). Но если 
интегрированные среды вам в новинку, сначала надо уяснить, что такое проект 
(ргодесо. Проект — это набор взаимосвязанных исходных файлов, компиляция и 
компоновка которых позволяет создать исполняемую \Лп4о%\’-программу или РИ. 
Исходные файлы проекта обычно хранятся в отдельном подкаталоге. Кроме того, 
зачастую проект зависит от многих файлов, расположенных вне подкаталога 
проекта, таких как включаемые (штса4е) и библиотечные файлы. 

\У15ща1 5Аю „МЕТ также поддерживает разработку приложений вне интегри- 
рованной среды с применением сборочных файлов проекта, или таКе-файлов 
(таке Нез). МаКе-файл содержит параметры компилятора и компоновщика, а также 
отражает все взаимосвязи между исходными файлами. То есть вы вправе создать 
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таке-файл вручную и исполнять его средствами программы ММАКЕ.ЕХЕ. (Файлу 
с исходным кодом нужны включаемые файлы, исполняемому файлу — определен- 
ные объектные модули, библиотеки и т. д.) Программа ММАКЕ.ЕХЕ считывает таке- 
файл, а затем вызывает компилятор, ассемблер, компоновщик и компилятор ре- 
сурсов, чтобы получить на выходе нужный файл — исполняемый или библиотеч- 
ный. Эта программа, руководствуясь указанной ей информацией, заставляет, на- 
пример, компилятор генерировать ОВ]-файл из определенного СРР-файла. Кста- 
ти, в \15ща! С++ МЕТ больше недоступна возможность экспорта таке-файла ак- 
тивного проекта из среды разработки. Для сборки проектов У151а! С++ МЕТ в ко- 
мандной строке применяется параметр компилятора Беуепь. 


» - Меговой МзнаГ С + + [Чет] - Мавует.сор 
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Рис. 1-2. Окна Убий С++ МЕТ 


В проекте У15ща1 С++ МЕТ взаимозависимости между отдельными частями опи- 
саны в текстовом файле проекта с расширением УСРКО). А специальный тексто- 
вый файл решения с расширением $1ГМ содержит список всех проектов данного 
решения. Решение (Зойоп) объединяет несколько проектов (но во всех приме- 
рах этой книги оно состоит из одного проекта). Чтобы начать работу с существу- 
ющим проектом, достаточно открыть в У1зиа1 С++ МЕТ соответствующий $1М-файл, 
и проект можно редактировать и собирать. 

\150а! С++ МЕТ также создает промежуточные файлы нескольких типов (табл. 1-1). 


Табл. 1-1. Типы файлов, создаваемых в проектах \М1зца! С++ .МЕТ 


Расширение файла __ Описание 


АР Поддержка просмотра ресурсов 

В$С Информация браузера 

ОЕ Файл на языке описания интерфейсов ШГ. 
МСВ Поддержка просмотра классов 


см. след. стр. 
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Табл. 1-1. (продолжение) 


Расширение файла | Описание 


ГМ Файл решения. Не удаляйте и не изменяйте эти файлы 
средствами текстового редактора! 

500 Поддержка параметров и конфигурации решения 

УСРКО] Файл проекта. Не удаляйте и не изменяйте эти файлы 


средствами текстового редактора! 


Редакторы ресурсов и просмотр ресурсов проекта 


Открыв окно просмотра ресурсов Везоигсе \Че\у (команда Везоигсе меню Мет”) в 
\У150а! С++ МЕТ, можно редактировать ресурсы проекта. В основном окне распо- 
лагается редактор ресурсов (гезоигсе еАйог), предназначенный для конкретного 
типа ресурсов. Это может быть и \/У$ТУ/УС-редактор меню, и мощный графичес- 
кий редактор диалоговых окон, и набор инструментов для операций со значка- 
ми, растровыми изображениями и строками. Кроме стандартных элементов управ- 
ления УЛп4о\уз, редактор диалоговых окон позволяет вставлять и элементы управ- 
ления Аспуех. 

В каждом проекте обычно есть один ВС-файл, в котором описаны ресурсы меню, 
диалоговых окон, строк и «быстрых клавин». Этот файл также обычно содержит 
операторы #тсшае, «собирающие» ресурсы из других подкаталогов. В эти ресур- 
сы включаются как характерные для конкретного проекта, например, ВМР-фай- 
лы или файлы значков (ГСО), так и общие для всех программ У15а1 С++ МЕТ, на- 
пример, строки сообщений об ошибках. Модифицировать ВС-файлы вне графи- 
ческого редактора не рекомендуется. Редактор ресурсов способен обрабатывать 
ЕХЕ- и ОИ-файлы, благодаря чему вы, например, сможете заимствовать растро- 
вые изображения и значки у «чужих» УЛп4о\’з-программ. 


Компилятор С/С++ 


Компилятор У15ча| С++ МЕТ способен обрабатывать исходный код и на С, и на 
С++ — язык он определяет по расширению файла с исходным кодом. Расшире- 
ние С указывает на код на С, а СРР или СХХ — на С++. Компилятор удовлетворяет 
стандартам АМ$1, включая самые последние рекомендации рабочей группы по 
библиотекам С++, и обладает рядом расширений, введенных М!сгозой. Шаблоны, 
обработка исключений и идентификация типов во время исполнения (гапите суре 
1Чепийсацоп, КТТ!) — все это поддерживается в У15иа! С++ МЕТ. Введена также (хотя 
и не интегрирована в библиотеку МЕС) стандартная библиотека шаблонов 
(ЗГапаага Тетр!а(е Табгагу, $Т). 


Редактор исходного текста 


\У15ща! С++ МЕТ содержит мощный редактор исходного текста, поддерживающий 
массу возможностей: выделение цветом синтаксических конструкций, автоотсту- 
пы, раскладки клавиатурных команд популярных редакторов (например, УП и 
ЕМАС5), а также высококачественную печать. В версии 6.0 У15иа1 С++ появилась 
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впечатляющая новая функция АиюСотри/ее. Если вы работали с приложениями 
семейства Мисгозой ОЁйсе или с М!сгозой У15ча| Вая1с, то наверняка знаете, что это 
такое. Когда вы набираете несколько начальных символов оператора программы, 
редактор предлагает выбрать ключевое слово из списка вариантов. Это очень удоб- 
но, если вы работаете с объектами С++ и забыли точное имя члена класса, не- 
важно, функции или переменной, — все они в списке перед вами. Благодаря 
АшоСотр!ее не нужно забивать память форматами тысяч функций 1032 АР! 
или постоянно обращаться к интерактивной справочной системе. 


Компилятор ресурсов 


Компилятор ресурсов в \У154а! С++ МЕТ считывает созданный в графическом ре- 
дакторе А$СП-файл описания ресурсов (ВС) и создает для компоновщика двоич- 
ный КЕ5-файл. 


Компоновщик 


Компоновщик считывает ОВ]- и ВЕ5-файлы, сгенерированные компилятором С/ 
С++ и компилятором ресурсов, и обращается к МВ-файлам за МЕС-кодом, кодом 
библиотек периода исполнения и \/ш40о\%5. После этого он создает ЕХЕ-файл 
проекта. Возможность компоновки с приращением (шсгетериа! ПоК) заметно уско- 
ряет процесс, когда в исходные файлы вносятся лишь незначительные измене- 
ния. Заголовочные файлы МЕС содержат операторы #ргавта (специальные ди- 
рективы компилятора), указывающие нужные библиотечные файлы, так что яв- 
ным образом сообщать компоновщику, к каким библиотекам обращаться, не надо. 


Отладчик 


Если ваши программы начинают работать сразу, отладчик не нужен. Ну а нам, 
простым смертным, приходится им от случая к случаю пользоваться. Интегриро- 
ванный в \!51а1 С++ МЕТ отладчик (рис. 1-3) обладает как возможностями отлад- 
чиков более ранних версий \151а| С++ и \У15а[ Ваз!с, так и новыми. Вот они. 


@ Отладка программ на нескольких языках \150а| ЗаАю „МЕТ позволяет от- 
лаживать решения, отдельные проекты которых написаны на разных языках. 

Ш Подключение к работающей программе Можно подключаться и отлажи- 
вать программу, которая уже исполняется вне среды разработки У150а1 ао 
„МЕТ. 

Ш Удаленная отладка Теперь вы вправе подключиться и отладить программу 
на другом компьютере. 

Ш Отладка \еБ-приложений АЗРМЕТ Файлы АЗРМЕТ компилируются, поэтому 
к их отладке следует относиться так же, как и к отладке программ на других 
языках. За счет этого значительно облегчается отладка \еБ-приложений. 

Я Классы .МЕТ ЕгатеууогК для отладки и трассировки кода Упрощают 
размещение операторов трассировки кода в тексте программы. Эти классы 
состоят из управляемого кода, поэтому их можно исполнять в рамках управ- 
ляемого С++. 
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Панель отладки Оебид 


з "зодаёх. в” 
"ех0За. в" 
"МазаРсю. В" 


В ао {© ехоЗа.ехе!СехоЗадрр: плирлевалсе0 пе 58 
мехозем{еч. в" | ое70д, ЧНАБОМОМат(НИМ5ТАМСЕ  * Плявапсе=0х004 С++ 
\. Н ехОЗа.ехе!\ИпМай(НИМЕТАМСЕ _ * Млзапсе=0х00400 С++ _ 
\липМатСВТкатир() Ипеё 392 + ОхЗЬ [4 
аи} 


0х00429310 4а5 СехОЗайрр (Нейдрр, 


Окно 10са!$ Окно М/асй Другие отладочные окна 
Рис. 1-5. Окно отладчика Убий С++ МЕТ 


В окнах Уама ез и \/а(сВ можно развернуть указатели объектов, что приведет 
к отображению всех переменных-членов производного класса и базовых классов. 
Если же поместить указатель мыши на простую переменную, отладчик покажет 
се значение в маленьком окошке. При отладке программу надо собирать с пара- 
метрами компилятора и компоновщика, которые предусматривают генерацию 
специальной отладочной информации. 

В \У!54а! С++ .МЕТ есть функция Еай апа Сопйпие, позволяющая прерывать 
процесс отладки, изменять текст программы, а затем продолжать отладку уже 
измененной программы. Это сильно ускоряет отладку, так как больше не нужно 
вручную выходить из отладчика, перекомпилировать программу и лишь затем снова 
запускать отладку. Чтобы задействовать эту функцию, достаточно в процессе от- 
ладки отредактировать исходный код и нажать кнопку СопИпие (синий треугольник 
на панели инструментов). \У15иа1 С++ .МЕТ скомпилируют измененную программу 
и перезапустит отладчик. 


МЕС АррИсаНоп МПгага 


МЕС АррИсайоп \/Л2ага — генератор кода, создающий рабочую заготовку \Лп9оу\з- 
приложения с теми компонентами, именами классов и исходными файлами, ко- 
торые вы задали в его диалоговых окнах. Изучая примеры этой книги, вы будете 
интенсивно использовать мастер МЕС АррИсацоп У/гага. Только не путайте его 
со старыми генераторами кода, формировавшими весь код приложения. МЕС 
АррИсайНоп У/Л2агА создает минимум — главная функциональность сосредоточе- 
на в базовых классах каркаса приложений. 
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МЕС АррНсаНоп \/Л12ага поможет вам побыстрее приступить к работе над но- 
вым приложением. Более того, мастера расширяемы, т. е. вы вправе создавать соб- 
ственные генераторы кода. И если ваша команда занята разработкой множества 
проектов, скажем, в области телекоммуникаций, можно построить свой мастер для 
автоматизации работы. 


Окно С1а$$ Мем 


Окно С!а$$ Уле\у открывается при выборе команды С1а5$ У1е\\ в меню У1е\\ и ото- 
бражает дерево всех классов проекта с функциями-членами и переменными-чле- 
нами (рис. 1-2). Чтобы увидеть код элемента, его нужно дважды щелкнуть. При 
внесении изменений в исходный текст содержимое окна С1!а$$ У1е\” автоматичес- 
ки обновляется. В предыдущих версиях \15иа1 С++ для выполнения практически 
всех задач по управлению кодом классов применялся один-единственный компо- 
нент — С!а55\/Л1лага. Ему на смену пришли несколько новых мастеров, отвечающих 
за выполнение отдельных задач, таких как добавление совсем новых классов, 
виртуальных функций в классы и функций-обработчиков сообщений. В частно- 
сти, на смену добавлению классов и функций пришла утилита С!а55 У1еуу. 


Средство просмотра исходного кода 


Если вы пишете программу «с нуля», то, видимо, хорошо представляете себе ее 
структуру: все файлы с исходным кодом, классы и функции-члены. Но чтобы ра- 
зобраться в чужой программе, вам точно потребуется помощь. В \150а! С++ МЕТ 
предусмотрено средство просмотра исходного кода (Зопгсе Вго\узег), или попросту 
средство просмотра. Оно позволяет анализировать (и редактировать) программу 
через призму конкретного класса или функции, а не файла или файлов. В чем-то 
оно напоминает инструменты-инспекторы, доступные с другими объектно-ори- 
ентированными библиотеками, например $таШа!. Средство просмотра работа- 
ет в следующих режимах. 


Ш Пейп11010$ апд Ве егепсе$ (определения и ссылки) Выбрав функцию, 
переменную, тип, макрос или класс, вы увидите, где они определены и где 
именно используются. 

Ш Са СгарЬ/Са[Пег СгарЬ (схема вызываемых или вызывающих функций) 
Выбрав функцию, вы увидите графическое представление функций, вызывае- 
мых ею или вызывающих се. 

Ш Пелуед (1255 СгарЬ/Вазе С1а5$ СгарЬ (схема производных или базовых 
классов) Графическая схема иерархии классов. Выбрав класс, вы увидите его 
производные или базовые классы. При помощи мыши можно управлять сте- 
пенью детализации («развертки») иерархии. 

Ш ЕШе Оше (конспект файла) Для выбранного файла классы, члены клас- 
сови функции появляются вместе с указанием на все места программы, где они 
определены и используются. 


Типичный пример окна средства просмотра см. в главе 35. 
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Примечание Если вы перегруппируете строки в любом из файлов с исходным 
кодом, У151а! С++ МЕТ обновит используемую средством просмотра базу 
данных в момент повторной сборки проекта. На это, естественно, уй- 
дет дополнительное время. 


Кроме упомянутого выше средства, в У150а! С++ .МЕТ имеется новый режим 
просмотра — С1а$$ У1еу, независимый от базы данных, используемой при просмот- 
ре. В этом режиме показывается дерево всех классов в проекте вместе с функци- 
ями-членами и переменными-членами. Щелкнув какой-нибудь компонент, вы тут 
же увидите соответствующий исходный код. Однако в отличие от средства про- 
смотра режим С!а55 Уе\у не позволяет отображать информацию об иерархии. 


Зоиоп Ехр!огег 


В бошиоп Ехр!огег отображается структура всего проекта. Приложение в У!5иа1 
5ию „МЕТ может состоять из многих элементов, в том числе из многих проек- 
тов. зомйоп Ехрюгег позволяет управлять всеми элементами решения. 

Окно 5ошНоп Ехрюгег содержит древовидное представление элементов про- 
скта, которые можно открывать по отдельности для модификации или выполне- 
ния задач по управлению. В дереве отображаются логические отношения реше- 
ния и проектов, а также элементов решения. Чтобы связать файлы с решением, 
но не с одним из его проектов, достаточно присоединить его прямо к решению. 


ОБес+{ Вгомизег 


\У15ча! С++ МЕТ ОБеси Вго\узег позволяет изучать (и редактировать) приложение 
с точки зрения классов и функций, а не отдельных физических файлов. В этом 
смысле он напоминает инструменты-инспекторы, имеющиеся во многих объект- 
но-ориентированных библиотеках, в частности ЗтаШа/К. 

Чтобы открыть окно ОБесЕ Вго\у5ег, в подменю Офег ХЛпаоуу$ главного меню \е\у 
выберите команду ОБесе Вгоуузег. В ОБесе Вгоуузег несколько режимов просмотра. 
Ш ПеНп101$ апд геЁегепсе$ Можно выбрать любую функцию, переменную, тип, 

макрос или класс и посмотреть, где она определена и используется в проекте. 
Ш $огЫпе Сортировка объектов и членов по алфавиту, по типу или виду доступа, 


Ш Пепуед С1а$5е5 ап МетЪег$/Вазе С1а55е5 апд Метфег$ Графические схе- 
мы иерархии классов. У выбранного класса можно посмотреть производные 
и базовые классы с их членами. Уровень иерархии выбирается мышью. 


Стандартное окно утилиты ОБеси Вго\’зег представлено в главе 3. 


Примечание Если изменить порядок строк исходного кода, У15иа|! С++ МЕТ 
обновит базу данных ОБес! Вго\узег при следующей сборке проекта. Это 
займет некоторое время. 


УМЕ-инструменты 


Теперь в У150а! С++ „МЕТ появились инструменты моделирования на языке ОМГ, 
(Огшйеа Модейпз Гапзчазе), представляющем собой набор соглашений о созда- 
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нии диаграмм и описаний программы, описывающих систему. Среди поддержи- 
ваемых типов ОМГ-схем диаграммы классов, объектов, действий и состояний. Во 
многих организациях ПМГ, применяется как стандартное средство документиро- 
вания систем. 

В \!5иа1 С++ МЕТ есть команда в меню Рго}есё для обратного преобразования 
проекта в ОМТ-диаграмму. Для обратного преобразования проекта У15иа! С++ МЕТ 
в набор ОМ!-диаграмм сначала надо собрать информацию о проекте для ОБеси 
Вгоуузег, а затем последовательно выбрать команды \131о ОМГ и Веуегзе Епашеег 
в меню Ргоуесе. У15иа! С++ МЕТ создаст ОМГ-пакет (набор диаграмм) проекта, от- 
кроет \1910 и отобразит в нем пакет. (ОМГ-диаграммы создаются в формате У1510.) 


Примечание Для просмотра раздела интерактивной справочной системы, 
посвященного ОМТ-решениям У15$10, должно быть открыто приложение 
\У 1510. В конце процедуры установки У1зца! Знаю МЕТ Егцегризе Агспиесе 
мастер предлагает установить У1510. 


———————————————————ы————»ыы——Ш6ШбШб6б—0—— 


Интерактивная справочная система 


В версии 6 среды У1зиа! С++ справочная система перенесена в формат НТМЕ и 
выделена в отдельное приложение — М$ОМ ШМЬгагу Млеууег. Темы размещаются в 
отдельных НТМ!-документах, а сами документы компилируются в проиндексиро- 
ванные файлы. В МОМ ИЬгагу Уле\ег используется код из Мисгозой Имегпее ЕхрЮ- 
гег 4.0, и поэтому справочная система работает, как хорошо знакомый вам \/Ъ- 
браузер. Справочная система обеспечивает доступ к справочным файлам, нахо- 
дящимся как на компакт-диске У15иа1 С++ .МЕТ (выбор по умолчанию), так и на 
жестком диске, а также к НТМТ--файлам в Интернете. Получить справку можно по- 
разному. 


Ш По книге Команда Согиеп{$ меню Нер среды разработки открывает окно 
Сомеп($, отображающее информацию о документации У15иа1 та о „МЕТ и 
библиотеке М$ОМ. Документация по \У1з4а1 5а о МЕТ, МЕТ Егате\уогк $ОК и 
Р!аКоги 5ОК представлена иерархически по книгам и главам. Содержание 
определяется выбранными фильтрами. 

Ш Потеме Команда шаех меню Нер среды разработки открывает окно шаех. 
Чтобы получить список относящихся к тому или иному ключевому слову тем 
и статей, достаточно ввести его в поле и выполнить поиск. Содержание опре- 
деляется выбранными фильграми. 

@ Послову Команда $еагсв меню Не!р среды разработки открывает окно Зеагсв, 
используемое для полнотекстового поиска документов, в которых встречают- 
ся определенные слова. Содержание определяется выбранными фильтрами. 

Ш Динамическая справка Позволяет получать от У151а1 $4 ю .МЕТ ссылки на 
информацию о конкретной области, в которой вы работаете, или задачи, ко- 
торую пытаетесь выполнить в ШЕ-среде. 

Ш Контекстная справка по нажатию клавиши Е1 Лучший друг программи- 
ста. Поместите указатель на имя функции, макроса или класса, нажмите кла- 
вишу Е1, и справочная система примется за работу. Если имя встречается в 
нескольких местах (скажем, в справочных файлах МЕС и \Л1п32), откроется окно 
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1пасх со списком соответствующих тематических разделов, из которых мож- 
но выбрать нужный. 


Независимо от способа получения любой фрагмент справки можно скопиро- 
вать в буфер обмена и перенести, например, в программу. 


Диагностические утилиты 


В У!5на! С++ МЕТ есть ряд полезных диагностических инструментов. $РУ++ пока- 
зывает дерево процессов, потоков и окон, существующих в системе. Он позволя- 
ст также просматривать сообщения и исследовать окна исполняемых приложе- 
ний. В У15иа1 С++ МЕТ имеется и богатый набор АспуеХ-утилит, программа для 
тестирования элементов управления Асйуех и другие инструменты. 


Библиотека МЕС версии 7 


Библиотека МЕС версии 7 определяет каркас приложений, с которым вам надо 
познакомиться поближе. В главе 2 вы увидите настоящий код и узнаете ряд важ- 
ных положений. 


Библиотека АТЕ версии 7 


Библиотека АТП, отделена от МЕС и применяется для создания элементов управ- 
ления АсцуеХ. Вообще писать элементы управления АснуеХ можно как на МЕС, 
так и на АПТ, но АТГ-элементы гораздо меньше по объему кода и быстрее загру- 
жаются через Интернет. В главах 27 и 28 вы познакомитесь с АТ", и методиками 
создания элементов управления АсйуеХ средствами АТГ. 


Поддержка .МЕТ 


У!5чща1 За ю .МЕТ полностью поддерживает каркас МЕТ Егате\хогК. Хотя ОЛ,-биб- 
лиотеки, С++, библиотеки МЕС, СОМ и АТ, можно применять совместно для раз- 
работки УЛп4о\з-приложений, у созданной таким образом системы появляется 
ряд неприятных свойств. Иногда кажется, что связи некоторых частей слишком 
искусственны. Одна из главных задач МЕТ — унификация модели программиро- 
вания, т. е. обеспечение большего единства платформы Хто‘. СТГК-среда пред- 
полагает единый набор типов в синтаксисе всех программ. АЗРМЕТ также рабо- 
тает под управлением СТК, так что разработка \еБ-приложений тоже унифици- 
руется. 

Кроме того, управляемый код есть не только в \У1зиа! Вазс МЕТ — Мисгозой 
расширила С++, добавив поддержку управляемого кода — управляемый С++ (Мапа- 
зе Ехеп$1ю015), позволяющий создавать код, исполняемый СГВ-средой. Очень много 
особенностей кода на С++ сохранено, и предполагается, что Мапазеа Ех{еп$!0п$ 
облегчит переход в среду .МЕТ. Подробно о МЕТ и роли У!50а! С++ .МЕТ в созда- 
нии приложений МЕТ мы расскажем во второй части. 


ГЛАВА 


Каркас приложений Мсго$ой 
Гочпаайоп Саз$ /огагу 


В этой главе вы познакомитесь с каркасом приложений М1сгозой Еоип4аНоп С1а$$ 
ИБгагу версии 7.0 (библиотеки МЕС). В следующих главах вам встретятся хотя и 
урезанные, но вполне работоспособные УЛпао\з-программы на базе МЕС, кото- 
рые помогут уяснить, как же программируют с применением каркаса приложе- 
ний. Мы постарались свести к минимуму объем теоретических сведений, однако 
включили дополнительные разделы, посвященные сопоставлению сообщений, а 
также документам и видам, — они помогут осмыслить примеры из следующих глав. 


Назначение каркаса приложений 


Чтобы создать приложение для \Лп4о\5, надо выбрать среду разработки. И если 
вы уже отвергли варианты, не связанные с языком С (скажем, М!сгозой У15а] Вас 
или Войапа РерЬ)), у вас все же остается несколько путей: 

Ш программировать на С, применяя \/п32 АРГ, 

Ш написать на С++ свою библиотеку классов, использующую №1132; 

Ш задействовать каркас приложений на базе МЕС; 
ы 


выбрать другой каркас приложений, например ОБесе \Ип4оууз ГАБгагу (О\ХЛ.) 
фирмы Войапа (1при!5е). 


ИИ ИАА ИАН 


Примечание О программировании с помощью МЕТ \Июаоууз Еогта$ см. часть 6. 


Если вы начинаете с нуля, вам потребуется очень многому учиться. Вы уже умеете 
программировать \/п32? Хорошо, но все равно придется осваивать библиотеку 
МЕС. Дело в том, что МЕС очень быстро стала доминирующей библиотекой клас- 
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сов для УЛшао\. Даже если вы знакомы с МЕС, не помешает еще раз вспомнить 
основные особенности этого программного продукта. 

Библиотека МЕС — интерфейс программирования на С++, расположен- 
ный поверх АР \Лп4д0уу$. Язык С++ сегодня является стандартом для разработ- 
ки серьезных приложений и пользуется мощной поддержкой самых разных ком- 
паний. Чтобы создавать максимально производительные приложения, нужно 
программировать максимально близко к УЛп4о\у$ АРТ. С++ и МЕС предоставляют 
такую возможность, избавляя от написания методов УиаРгос вручную. 

«Каркасные» приложения имеют стандартную структуру. Приступая к 
крупному проекту, нужно выработать структуру кода. Но эта структура у каждого 
программиста своя, и новому участнику команды трудно приспособиться к ней. 
Каркас приложений на базе МЕС предлагает свою структуру, отработанную на 
многих проектах и опробованную в разных программных средах. Создав УЛаао\з- 
программу на базе библиотеки МЕС, можно спокойно удалиться хоть на Карибы — 
оставшиеся дома без проблем смогут поддерживать и совершенствовать вашу 
программу. 

Не подумайте только, что структура библиотеки МЕС сковывает программу, 
лишая ее гибкости. При работе с МЕС можно в любой момент вызвать любую \Лп32- 
функцию, т. е. в полной мере задействовать возможности и преимущества УЛпоуу5. 

Достоинства «каркасных» приложений — компактность и высокая ско- 
рость работы. Во времена 16-разрядного программирования можно было создать 
исполняемый файл УЛпао\з-программы размером меньше 20 кб. Сегодня ХИпао\з- 
программы гораздо больше, и одна из причин в том, что 32-разрядный код объем- 
нее. Даже используя большую модель памяти, \/16-программы оперировали с 
16-разрядными адресами стековых и многих глобальных переменных. А \/1132- 
программы всегда используют 32-разрядные адреса и часто работают с 32-раз- 
рядными целыми значениями — они эффективнее 16-разрядных. Много памяти 
расходует и новый код обработки исключений в С++. 

Вспомните: разве в тех 20-килобайтовых программах были стыкуемые пане- 
ли инструментов (аосют8 тоорагз), разделяемые окна, режим предварительно- 
го просмотра перед печатью, поддержка контейнеров с элементами управления — 
словом, все те возможности, которых пользователи ждут от современных программ? 
МЕС-программы потому и объемнее, что делают больше и выглядят лучше. К сча- 
стью, теперь можно создавать программы, динамически связываемые с МЕС-ко- 
дом (и С-кодом периода исполнения), так что их размер опять уменьшается — со 
192 кб до примерно тех же 20 кб. Разумеется, такой программе понадобится мас- 
са О-модулей, но в наши дни от этого никуда не деться. 

Что до скорости работы программ, то вы имеете дело с машинным кодом, 
который сгенерирован оптимизирующим компилятором. Программы исполняются 
быстро, но при их запуске можно заметить задержку — в этот момент загружают- 
ся вспомогательные ОГ-модули. 

Средства У1$иа1 С++ .МЕТ уменьшают необходимость в написании ру- 
тинного кода. Редакторы ресурсов, МЕС АррИсацоп У/агА и мастера средства 
С1аз$ У1еуу значительно ускоряют написание кода, характерного для конкретного 
приложения. Например, редактор ресурсов создает заголовочный файл с уже опре- 
деленными значениями для #4ейпе-констант. МЕС АррИсацоп У/гагА генерирует 
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«скелет» всего приложения, после чего в окне свойств можно добавлять обработ- 
чики сообщений и сопоставлять им сообщения. 


У библиотеки МЕС огромное количество разнообразных возможностей. 


Классы библиотеки МЕС версии 1.0, поставлявшиеся с Мсгозой С/С++ версии 7.0, 
поддерживали следующие возможности: 


интерфейс С++ с УЛадо\з АР; 


классы общего назначения (не относящиеся непосредственно к УЛю4о\5), в том 
числе: 


О наборы классов для списков, массивов и карт (тарэз); 

удобный и эффективный строковый класс; 

классы для работы со временем, временными интервалами и датами; 
классы для независимого от ОС доступа к файлам; 


поддержка систематизации сохранения объектов на диске и их считывания 
с диска; 


0000 


иерархия классов от общего корневого объекта; 


поддержка приложений с многодокументным интерфейсом (Мире Росштепе 
НиеГасе, МОГ; 


поддержка ОГЕ версии 1.0. 


Вторая версия (включенная в У154а! С++ 1.0) приняла эстафету у первой вер- 


сии: введены поддержка функций пользовательского интерфейса современных 
УЛпао\з-приложений, а также каркасная архитектура приложений. В МЕС 2.0 
ПОЯВИЛИСЬ: 


полная поддержка команд Ореп, $ауе, бауе Аз в меню ЕЦе и списка последних 
открывавитихся файлов; 

предварительный просмотр перед печатью и поддержка принтера; 
поддержка окон с прокруткой и разбиением; 

поддержка панелей инструментов и строк состояния; 

доступ к элементам управления \150а! Ва$1с; 

поддержка контекстно-зависимой справки; 

поддержка автоматической обработки данных, вводимых в диалоговом окне; 
улучшенный интерфейс с ОТЕ 1.0; 

поддержка РИ. 

Классы версии 2.5 (в \У150а! С++ версии 1.5) ввели в библиотеку МЕС: 
поддержку механизма ООВС, что позволило приложениям оперировать инфор- 


мацией, хранящейся в таких базах данных, как М1сгозой Ассезз, ЕохРго и Мсго- 
50 ОТ, 5егуег; 


интерфейс с ОТЕ 2.01, включая поддержку редактирования «по месту», связы- 
вание, перемещения объектов мышью (@га апа агор), а также ОГЕ АшотачНоп. 


У15иа1 С++ 2.0 была первой 32-разрядной версией продукта и поддерживала 


УЛпао\з$ МТ 3.5. В нее входила МЕС версии 3.0 с такими новыми возможностями: 


поддержка диалоговых окон с вкладками (входила и в версию 1.51 У150а! С++, 
поставляемую на том же компакт-диске); 


стыкуемые панели элементов управления, реализованные в МЕС; 
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Ш поддержка окон с тонкими рамками (т-йате \1т40%5); 

Ш отдельный СОК (Сопго! РеуеюртепЕ К!) для построения 16- и 52-разрядных 
элементов управления на базе ОГЕ, хотя поддержка ОГЕ-контейнеров элемен- 
тов управления еще не предусматривалась. 

В последующей версии — У!5иа1 С++ 2.1 с МЕС 3.1 — добавились: 

Ш поддержка новых стандартных элементов управления из бета-версии \УИп- 
Чоу 95; 

Ш драйвер ООВС Геуе! 2, совместимый с ядром баз данных Ассез5 ТЕ 

Ш классы УЛ/л5осК для обмена данными по протоколу ТСРЛР. 

Далее Мсгозой решила «перескочить» через третью версию У1зиа! С++ и при- 
ступила прямо к четвертой — чтобы синхронизировать номера версий \1зиа! С++ 
и МЕС. В библиотеке МЕС 4.0 появились: 

Ш новые классы объектов доступа к данным на базе ОТЕ (Рага Ассез$ ОБес!з, РАО) 
для работы с ] ег; 

Ш стыкуемые панели элементов управления М!сгозой УЛшпао\$ 95 вместо пане- 
лей элементов управления МЕС; 

Ш полная поддержка стандартных элементов управления из финальной версии 
УИпа0%$ 95 с новыми классами древовидный список (\тее \еу’) и поле ввода с 
форматированием (исв-еай у1е\); 

Ш новые классы для синхронизации потоков; 


поддержка ОГЕ-контейнеров элементов управления. 

Важным этапом стала версия У!5иа! С++ 4.2 с МЕС 4.2 и такими возможностями: 
классы УЛптег 

классы серверов АсйуеХ-документов; 

классы синхронных и асинхронных моникеров Асйуех; 
усовершенствованные МЕС-классы элементов управления Асцуех, с такими 
возможностями, как активизация без образования окна, оптимизированный код 
рисования и т. д.; 

Ш улучшенная поддержка МЕС ОБВС, включая массированную загрузку наборов 
данных и пересылку данных без привязки. 


В У5иа[ С++ 5.0 с МЕС 4.21, в которой было исправлено несколько ошибок вер- 
сии 4.2, ввели еще несколько заслуживающих внимания возможностей: 


Ш обновленная среда разработки, Оеуеорег 561 97; ее особенности — основан- 
ная на НТМГ справочная система и интеграция с другими языками, в том чис- 
ле с ]ауа; 

Ш Аспуе Тетрие МЬгагу (АТГ) для эффективной разработки элементов управлё: 
ния Асйуех для Интернета; 

Ш поддержка в языке С++ при помощи директивы #йирой программирования 
СОМ-клиентов на основе библиотек типов (подробнее — в главе 25). 


У15ща! С++ 6.0 содержит МЕС 6.0 (заметьте: номера версий вновь синхронизи- 


рованы). Многие из возможностей МЕС 6.0 обеспечивали поддержку передовой на 
то время концепции М!сгозой Асиуе Р1аМогт: 
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Ш классы МЕС, инкапсулирующие новые стандартные элементы управления УЛ п- 
ао\з, которые являются составной частью в Имегпег Ехрюгег 4.0; 

Ш поддержка Рупапис НТМЕ, позволяющая МЕС-программисту разрабатывать 
приложения, способные динамически изменять и создавать НТМГ-страницы; 


Ш технология Асиуе Роситепе Сопиаштепь позволяющая приложениям, осно- 
ванным на МЕС, включать активные документы (АсНуе Роситеп($); 


Ш поддержка шаблонов поставщиков и потребителей ОТЕ РВ и привязки данных 
АРО, что очень удобно для разработчиков программ доступа к базам данных, 
использующих МЕС или АТИ. 

Последняя версия, \У1зиа! С++ МЕТ, содержит библиотеку МЕС 7.0, в которой 
обеспечена поддержка возможностей Интернет-программирования (и на новой 
платформе Мсгозой МЕТ), а также улучшены процедуры программирования для 
УЛпаоу’з. Среди новых возможностей: 

Ш усовершенствованная поддержка справочной системы на основе НТМЕ. в МЕС- 

приложениях; 

поддержка безоконных элементов управления; 

диалоговые окна и компоненты-редакторы в РНТМГ; 

классы обработки аргументов в НТМГ; 

диалоговое окно печати в УЛпао%$ 2000; 

более жесткий контроль типов в сообщениях; 

поддержка дат, следующих за 2038 годом. 


Путь, который вам предстоит 


Все это здорово, но вы, вероятно, подумали: «За так ничего не получишь». Верно. 
Чтобы эффективно пользоваться каркасом приложений, надо досконально изу- 
чить его, а это время. И если вам придется осваивать и С++, и УЛп4о\уз, и библио- 
теку МЕС (без ОГЕ), то сделать что-то полезное вы сможете не раньше, чем через 
полгода. Что интересно — на изучение одного только \/1т32 АР! уходит пример- 
но столько же времени. 

Как же так, спросите вы, если библиотека МЕС предлагает столько возможно- 
стей? Ну, прежде всего вам не избежать многого из того, чему вынуждены учиться 
\/1132-программисты на С. Исходя из опыта, можем сказать, что объектно-ори- 
ентированный каркас приложений упрощает обучение программированию для 
УЛпао\, если, конечно, вы разбираетесь в объектно-ориентированном програм- 
мировании. 

Безусловно, библиотека МЕС не сделает программирование для УЛп4о\у досто- 
янием масс. Здесь надо сказать, что «стоимость» УЛпаоуз-программистов на рынке 
труда выше, чем других, и вряд ли эта ситуация изменится в ближайшее время. 
Широкий спектр возможностей МЕС вкупе с мощью каркаса приложений слу- 
жит гарантией сохранения высокого спроса на программистов, умеющих рабо- 
тать с МЕС. 
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Каркас приложений 


Одно из определений термина каркас приложений (аррИисаноп ПатеугогК) тако- 
во: «интегрированный набор объектно-ориентированных программных компо- 
нентов, обеспечивающих все, что нужно для работы программы общего назначе- 
ния». Туманно, не так ли? Если вы действительно хотите знать, что такое каркас 
приложений, вам придется дочитать книгу до конца. Первым вам на помощь придет 
пример, с которым мы познакомимся чуть позже. 


Каркас приложений и библиотека классов 


Одна из причин популярности С++ в том, что этот язык можно «расширять» биб- 
лиотеками классов. Одни библиотеки поставляются с компиляторами С++, другие 
продают независимые фирмы, а какие-то создают сами программисты, так ска- 
зать, для внутреннего потребления. Библиотека классов — это набор взаимосвя- 
занных классов С++, которые можно задействовать в приложении. Например, 
математическая библиотека классов выполняет наиболее распространенные ма- 
тематические операции, а библиотека коммуникационных классов поддержива- 
ет обмен данными по последовательному каналу. Иногда вы конструируете объекты 
из предлагаемых классов, иногда создаете из них собственные классы — все за- 
висит от конструкции конкретной библиотеки. 

Каркас приложений — это надмножество библиотеки классов. Обычная биб- 
лиотека представляет собой изолированный набор классов, предназначенных для 
применения в любой программе, а каркас приложений определяет структуру са- 
мой программы. Концепцию каркаса приложений изобрела не Мсгозой — она 
сначала появилась в академических кругах, а первым коммерческим воплощени- 
ем стала МасАрр для Арре МасиозВ. С появлением МЕС 2.0 реализацией подоб- 
ных продуктов занялись и другие фирмы, в том числе Войапа (прие). 


Пример приложения на базе каркаса приложений 


Хватит общих рассуждений. Пора взглянуть на какой-нибудь код — не псевдо, а 
настоящий, который действительно можно скомпилировать и выполнить с биб- 
лиотекой МЕС. Угадайте, какой? Ну конечно, это старая добрая программа «НеНо, 
эоп4Ъ, правда, с некоторыми дополнениями. (Если вам доводилось работать с 
первой версией библиотеки МЕС, то этот код вам знаком, кроме базового класса 
окна-рамки.) Кстати, это почти минимум кода, необходимого для \тао\з-при- 
ложения с применением библиотеки МЕС. Сравните его с аналогичным чисто 
УЛ п32-приложением из книги Ч. Петцольда! Пока не пытайтесь разобраться во всех 
деталях. Не набирайте и не тестируйте его, потому что пример Ех21Ь на компакт- 
диске — практически полная копия. Потерпите до следующей главы — там-то вы 
и начнете работать с «реальным» каркасом приложений. 


ов ее 
Примечание Имена классов библиотеки МЕС принято начинать с буквы С. 


Ниже приведен исходный код для заголовочного файла и файла реализации 
(паретепаНоп Не) нашего приложения МуАрр. Два класса — СМуАрр и СМУЁта- 
те — наследуют базовым классам библиотеки МЕС. Сначала взгляните на заголо- 
вочный файл МуАрр.Н для приложения МуАрр: 


ГЛАВА 2 Каркас приложений Мсгозой Роипданоп С!азз Мбгагу 21 


// Класс приложения 
с1азз СМуАрр : руб11с С\УЗпАрр 


{ 
ру611с: 

У1г{иа1 ВОО Тп1{Тизфапсе(); 
}; 


// Класс окна-рамки 

с1азз СМуЕгате : руб11с СЕгате\па 

{ 

риуб11с: 
СМуЕгате(); 

рготестед: 
// “атх_п$9” означает, что следующие две функции являются 
// частью системы маршрутизации сообщений библиотеки МЕС 
аРх_т$9 \0149 ОпЕВи{Топбомп (ОТМТ пР1адз, СРо1п{ ро1пф); 
аРх_тз9 уо1а ОпРа1пт(); 
РЕСТАВЕ_МЕЗЗАСЕ_МАР() 


А вот файл реализации МуАрр.СРР для приложения МуАрр: 


#1пс1иде <аРхи1п. п> // Заголовочный файл библиотеки МЕС, 
// в котором объявлены базовые классы 

Нпс1иде “туарр. п” 

СМуАрр %НеАрр; // Единственный объект СМуАрр 


ВООЕ СМуАрр: : ТптТпзтапсе() 


{ 
т_рМафпмпа = пем СМуЕгате(); 
п_рМазим\Мпа->5вВом\1 пом (м_пСтазвом); 
т_рМазп\па->Урдатем1п9ом(); 
гефигпт ТВУЕ 

} 


ВЕСТМ_МЕЗЗАСЕ_МАР(СМуЕгате, СЕгатемпа) 
О№_иМ_ЕВУттомо0ммС) 
ОМ ММ_РАТМТ() 

ЕМО_МЕЗЗАСЕ_МАР() 


СМуЕгате: : СМуЕгате( ) 
{ 

Сгеате(Ми 1, “МУАРР Арр11сат1оп”); 
} 


\0149 СМуЕгапе : : Оп-Вифопбомп( ИТМТ пР1адз, СРо1пе ро1пе) 
{ 
ТВАСЕ( "Ептег1па СМуЕгате: : Оп-Виеопбомп - %1х, %4, %9\п” 
(1019) пР1а9з, розпф.х, ро1п*.у); 


22 


Часть |! Основные сведения о \М/тдомз и \М!зиа! С++ .МЕТ 


——ыы—ы»ы»—»—»—»»ы»»—»—»—»—»—»—_—_—__—___——э——э—э—э—э—э—ээ———————— 


\0149 СМуЕгате: :ОпРа1п{() 


{ 


СРа1п{0С 9с(111$): 
дс. Тех{0и{ (0, 0, “Не110, мог1а!“"); 


Теперь обсудим некоторые элементы программы. 


Функция Майи. ХЛпдоууз требует наличия этой функции в любой програм- 
ме. Здесь вы ее не видите потому, что она скрыта внутри каркаса приложения. 
Класс СМуАрр. Объект класса СМуАрр представляет программу. В программе 
определяется единственный глобальный объект класса СМуАрр — ФеАрр. Ба- 
зовый класс СУтАрр определяет основные характеристики поведения объек- 
та {реАрр. 

Запуск приложения. При запуске приложения Х/п4о\з$ вызывает встроен- 
ную в каркас приложений функцию УмМат, а та ищет глобально сконструи- 
рованный объект класса, производного от Старр. Не забудьте, что в програм- 
мах на С++ глобальные объекты конструируются перед исполнением основ- 
ной части программы. 

Функция-член СМуАрр:ЛтИтяапсе. Найдя объект-приложение, ИжМат 
вызывает виртуальную функцию-член иШтяапсе, которая делает вызовы, не- 
обходимые для создания и отображения на экране основного окна-рамки (таш 
Паше улпдо\) приложения. Вы должны переопределить и#тяатсе в своем 
производном классе «приложение», так как базовый класс СУмАрр не имеет 
представления о том, какого типа основное окно-рамку вы хотите создать. 
Функция-член СИтАрр::Кип. Функция Кип скрыта в базовом классе, но она 
распределяет сообщения программы между ее окнами, обеспечивая тем самым 
работу этой программы. ИиМат вызывает Кии после вызова [иШтияаисе. 
Класс СМуЕгате. Объект класса СМуЕгате представляет основное окно про- 
граммы. Когда конструктор вызывает функцию-член Стеше базового класса 
СЕгате\та, \Лпаохуз создает настоящую оконную структуру, а каркас прило- 
жения связывает ее с объектом С++. Для отображения окна на экране вызыва- 
ются функции 5роштаои и Орашетаои (это также функции-члены базо- 
вого класса). 

Функция СМуЁРгате::ОшШВиноп,оит. Включена для демонстрации возмож- 
ностей обработки сообщений в библиотеке МЕС. Мы объявляем о сопоставле- 
нии события «нажатие левой кнопки мыши» с функцией-членом класса СМуЕга- 
те. Подробнее сопоставление сообщений в библиотеке МЕС мы обсудим в 
главе 5, а пока просто примем к сведению, что эта функция вызывается при 
нажатии левой кнопки мыши. Функция использует макрос ТКАСЕ из библио- 
теки МЕС, чтобы вывести сообщение в отладочное окно. 

Функция СМуЕгате::ОпРайи. Каркас приложений вызывает эту функцию- 
член класса СМуЕгате всякий раз, когда надо перерисовать окно: в начале ра- 
боты программы, при изменении размеров окна и при обновлении всего окна 
или его части. Оператор СРай ОС относится к «классическому» СП1-интерфейсу 
и поясняется в следующих главах. Ну, а функция 1ехОшЁ выводит на экран «НеНо, 
\оПаЪ. (С СП+ мы познакомимся поближе при обсуждении МЕТ) 
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Ш Завершение приложения. Пользователь завершает приложение, закрывая 
основное окно программы. Тем самым он инициирует последовательность 
событий, заканчивающихся уничтожением объекта класса СМуЁтате, выходом 
из Кип, выходом из ИмМат и уничтожением объекта класса СМуАрр. 


Еще раз взгляните на пример и попробуйте теперь представить картину цели- 
ком. Очевидно, что большая часть возможностей программы сосредоточена в 
базовых классах библиотеки МЕС: СУтАЬр и СЕгате\па. Составляя МУАРР, мы 
следовали нескольким простым правилам структуризации и поместили ключевые 
функции в производные классы. Как видите, С++ позволяет «заимствовать» боль- 
шие объемы кода, не копируя его. Считайте это партнерскими отношениями между 
нами и каркасом приложений. Последний создает структуру программы, а мы — 
код, наполняющий эту структуру конкретным смыслом. 

Теперь вы, наверное, начинаете понимать, почему каркас приложения — не- 
что большее, чем библиотека классов. Он определяет не только структуру програм- 
мы — его роль значительнее, чем у базовых классов С++. Вы уже видели в действии 
скрытую функцию ИмМат, а прочие компоненты каркаса поддерживают обра- 
ботку сообщений, динамически подключаемые библиотеки и многое другое. 


Сопоставление сообщений в библиотеке МЕС 


Вспомним функцию-член ОйЁВийопроит из предыдущего примера. Можно поду- 
мать, что ОтШВинопроит — идеальный кандидат на роль виртуальной функции. 
При таком подходе базовый класс окна определил бы виртуальные функции для 
сообщений о событиях, связанных с мышью, и других стандартных сообщений, 
а производные классы окна могли бы при необходимости переопределять эти 
функции. Некоторые библиотеки классов для УЛп4о\$ именно так и устроены. 

Но в каркасе приложений библиотеки МЕС не используются виртуальные функ- 
ции для сообщений \Лшао\5. Вместо этого с помощью макросов определенные 
сообщения сопоставляются (тар) функциям-членам производных классов. Чем 
же объясняется отказ от виртуальных функций? Допустим, виртуальные функции 
для сообщений в МЕС все-таки применяются. Класс СУпа должен был бы объяв- 
лять виртуальные функции для не менее сотни сообщений. Для каждого произ- 
водного класса, задействованного в программе, С++ требует наличия таблицы дис- 
петчеризации виртуальных функций (уаЫе) (виртуальная таблица). Для каждой 
виртуальной функции в этой таблице потребуется 4-байтовая запись независимо 
от того, переопределена ли функция в производном классе. Так что для каждого 
типа окна или элемента управления приложению для поддержки виртуальных об- 
работчиков сообщений понадобится таблица размером более 400 байт. 

А как насчет обработчиков сообщений о выборе команд меню и щелчках кно- 
пок мыши? Их не определишь как виртуальные функции в базовом классе окна, 
так как в каждом приложении свой набор команд меню и кнопок. Система карт 
сообщений, принятая в библиотеке МЕС, позволяет обойтись без длинных вирту- 
альных таблиц и сглаживает различия между обычными У/1п9оу’-сообщениями 
и командными сообщениями, характерными для конкретных программ. Поэтому 
отдельные классы, отличные от оконных (классы «документ» и «приложение»), 
могут обрабатывать и командные сообщения. Для сопоставления (или увязки) 
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сообщений \Лп4оууз с функциями-членами С++ в МЕС применяются макросы. 
Расширения языка С++ не нужны. 

МЕС-обработчик сообщения требует наличия прототипа функции, тела функ- 
ции и соответствующей записи в карте сообщений. Вставлять обработчики сооб- 
щений в классы можно в окне Ргорегиез. Вы выбираете идентификатор \Апао\з- 
сообщения из списка, а мастер генерирует код с нужными параметрами функций 
и возвращаемыми значениями. 


Документы и их представление 


В нашем примере мы использовали объект-приложение и объект «окно-рамка». 
Но большинство реальных приложений на базе библиотеки МЕС гораздо слож- 
нее. Обычно они, помимо упомянутых, содержат еще два класса: «документ» (4оси- 
тепо и «вид», или «представление» (\1е\). Архитектура «документ-вид» — стержень 
каркаса приложений; она напоминает классы Моде!/\У1е\ /Сопиго|ег, принятые в 
среде зташа!кК. 

Проще говоря, архитектура «документ-вид» отделяет данные от их представ- 
ления пользователю. Очевидное преимущество этого подхода — возможность 
представить одни и те же данные по-разному. Пусть на диске хранится документ 
со сводкой котировок за месяц, а данные представляются в виде таблицы и гра- 
фика. Мы изменяем значения в окне табличного представления, и содержимое окна 
графического представления тоже изменяется, так как оба окна отображают одну 
и ту же информацию (но представленную в разных видах). 


\М/едпездау: 125.5 +6.16 
ТВыгеФау: 125.7 +010 
ЕИЧау: 124.5 -1.2 
Мопдау: — 125.0 +0.5 
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Рис. 2-1. Взаимосвязь документов и их представления 


В библиотеке МЕС документам и их видам сопоставляются экземпляры (шзап- 
се5) классов С++. Так, на рис. 2-1 показаны три объекта класса С5юсЁОос, соответ- 
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ствующие трем фирмам: АТФ, 1ВМ и СМ. Все три документа связаны с табличным 
представлением, а один — еще и с графическим (гистограммой). Как видите, здесь 
четыре объекта «вид»: три объекта класса СУюсТаетеи и один — класса СУЮсЕ- 
СрагИпеи. 

Код базового класса «документ» взаимодействует с командами Ореп и $ауе меню 
ЕЦе; само чтение и запись данных объекта-документа реализовано в производных 
классах «документ». (Каркас приложений берет на себя большую часть работы по 
выводу на экран диалоговых окон ЕЦе Ореп и Ейе 5ауе, а также по открытию, закры- 
тию, чтению и записи файлов.) Базовому классу «вид» сопоставлено окно, содер- 
жащееся внутри окна-рамки; производный класс «вид» взаимодействует со своим, 
сопоставленным ему классом «документ» и отвечает за операции ввода/вывода 
информации на экран и принтер. Производный класс «вид» и его базовые классы 
обрабатывают сообщения \//п4о\з. Библиотека МЕС «дирижирует» взаимодей- 
ствием документов, их представлениями, окнами-рамками и объектом-приложе- 
нием в основном посредством виртуальных функций. 

Не подумайте, что объект-документ надо обязательно связывать с дисковым 
файлом, целиком считываемым в память. Если, например, «документ» — на самом 
деле база данных, можно переопределить нужные функции-члены класса «доку- 
мент», и тогда по команде Ореп меню ЕЦе отобразится список баз данных, а не 
файлов. 
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ЧАСТЬ | 


ОСНОВЫ МЕС 


ГЛАВА 


Знакомство с мастером 
создания МЕС-приложения 


В главе 2 мы в общих чертах познакомились с архитектурой «документ-вид» биб- 
лиотеки МЕС. В данной главе вы увидите, как создать приложение на базе функ- 
ций этой библиотеки, не вдаваясь в сложности иерархии классов и взаимосвязей 
объектов. Вы поработаете только с одним компонентом программы — классом «вид» 
(уех\у с1а5$), тесно связанным с объектом «окно». Такие компоненты, как класс 
«приложение» (аррИсайоп с!а35), «окно-рамка» (йапле уйп9о\) и «документ», можно 
пока игнорировать. Ваша программа, конечно, не сможет сохранять свои данные 
на диске и не будет поддерживать множественное представление информации — 
о том, как это сделать, и о многом другом вы прочтете в части 3. 

Поскольку в \Ит4о\-приложениях важную роль играют ресурсы, вы будете 
использовать Везоигсе У1е\ для визуального просмотра ресурсов создаваемой 
программы. Кроме того, вы получите несколько советов по настройке среды 
\УИпаоу'$ для обеспечения максимальной скорости сборки программы, а также по 
оптимизации вывода отладочной информации. 
иран 
Примечание Чтобы скомпилировать и запустить примеры программ этой и 

следующих глав, надо установить на компьютере Мисгозой УЛпао\ МТ 4.0, 
УЛп9о\$ 2000 или УЛпао\$ ХР, а также все компоненты М!сгозой У15ща! 
С++ „МЕТ. Проверьте правильность настройки каталогов с исполняемы- 
ми файлами, библиотеками и включаемыми файлами среды У15иа! С++ 
„МЕТ. (Изменить пути к каталогам позволяет команда ОрНопз из меню 
Тоо15.) Если возникнут трудности, обратитесь к документации У15иа! С++ 


„МЕТ и файлам ВЕАОМЕ. 
—_—___ 
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Что такое «вид» 


С точки зрения пользователя, вид (у\1е\”) — это обычное окно, т. е. вы можете из- 
менять его размеры, перемещать и закрывать, как любые окна в приложениях 
УЛпао\у5. А с точки зрения программиста, это объект класса С++, производного 
от класса СИеи; библиотеки МЕС. Как и для любого объекта С++, поведение объекта 
«вид» определяется функциями-членами (и переменными-членами) соответству- 
ющего класса, включая и специфичные для приложения функции производного 
класса, и стандартные функции, унаследованные от базовых классов. 

\150а! С++ МЕТ позволяет создавать достаточно интересные УЛп4о\з-прило- 
жения, просто добавляя код в производный класс «вид», сгенерированный масте- 
ром МЕС АррИсайоп \УЛтага. Во время работы вашей программы каркас приложе- 
ния МЕС создает объект производного класса «вид» и отображает окно, тесно свя- 
занное с этим объектом С++. Как принято в С++, код класса размещается в двух 
исходных модулях: заголовочном файле (Н) и файле реализации (СРР). 


Типы МЕС-приложений 


Библиотека МЕС поддерживает приложения трех типов: с однодокументным (пе 
Роситепи ИцегЁасе, $0Т) и многодокументным (Мире РоситепЕ ИмегЁасе, МОТ) 
интерфейсами, а также с интерфейсом на основе многих окон верхнего уровня 
(мшир Тор-Геуе! УЛа4оууз Имегасе, МТП). С точки зрения пользователя, 50 — 
это приложение, состоящее из единственного окна. Работая с «документами» в 
дисковых файлах, в каждый момент времени оно способно загрузить только один 
документ. Пример 50]1-приложения — Моераа (Блокнот). В МО!-приложении есть 
несколько дочерних окон (сБИа ул 90$), в каждое из которых загружается свой 
документ. Прекрасный пример такого приложения — версии Мсгозой \/ога, пред- 
шествующие М!сгозой У/ога 2000. 

В мастере МЕС АррИсацоп \У/гага по умолчанию создается МОГ-приложение. 
В начальных примерах этой книги мы будем создавать $П[-приложения, так как в 
них меньше классов и требуется учитывать меньше параметров. Каждый раз вам 
придется позаботиться о выборе в качестве типа приложения 5ше Роситепи в 
первом диалоговом окне МЕС АррИсаНоп У/12ага. С главы 18 мы будем создавать 
МО1-приложения. Архитектура каркаса приложений МЕС позволяет легко преоб- 
разовывать большинство $О1-примеров в МО!-приложения. 


Пользовательские интерфейсы МЕС-приложений 


Кроме $501-, МО1- и МТ!-стилей пользовательского интерфейса, библиотека МЕС 
позволяет создавать приложения со стандартным пользовательским интерфейсом 
или интерфейсом в стиле УЛюао\з Ехрюгег. Примеры приложений с «классичес- 
ким» интерфейсом — М!сгозой \/огА и М1сгозой РашигазВ. Интерфейс в стиле 
УЛпао\5 Ехр!огег состоит из двух панелей: левая содержит древообразный вид с 
развертываемыми узлами, правая — представление в виде списка. Естественно, что 
УЛпао\5$ ЕхрЮгег — наглядный пример подобного интерфейса. 
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Пример ЕхОЗа: «пустое» приложение 


МЕС АррНсайоп \/Л2ага генерирует код работающего МЕС-приложения, которое 
просто отображает на экране пустое окно с меню. Позже вы добавите код, «рису- 
ющий» внутри окна, а пока просто создадите простейшее приложение. 


1. Сгенерируйте код $01-приложения средствами МЕС АррИсаНоп У/12ага. 
В подменю Меуу меню Е|е выберите команду Рго]есь, в открывшемся диалого- 
вом окне выберите узел У15а| С++ Рго}ес$, а в списке шаблонов — МЕС Арри- 
саНоп: 


Меш РгозесЕ 


_ . т ] 
я а . . 


{1 зешр ап Оерюутеге РгодесЕз 


з . | МЕСОЦ = МЕСТБАРТ 
{2 ОННег Ргодес5 Еделзюп И 


{2 виа! видю бомНопз 


| мпзг РгодесЕ 


В поле ГосаНоп введите путь С\усрр№ 8) а в поле Рго]есЕ Мате — Ех0За и 
щелкните ОК. Ссылки левой панели позволяют перемещаться по страницам 
мастера МЕС АррИсайоп УЙгага и настраивать параметры будущего приложения. 

На странице АррНсаНоп Туре выберите вариант те Чоситепи и оставьте 
без изменений остальные свойства приложения: 


Аррйсабоп Туре 


Эрефу боситепЕ\Менн агсРкескиге иррок, (апоцаде, ап ке!асе 5Е/е орнопз Рог усиг 
аррйсаноп. 


Заметьте: на странице Сепега{е4 С1а$5е5 имена классов и файлов соответ- 
ствуют названию приложения — ЕхОЗа. На данном этапе эти имена можно 
изменить. Щелкните Е115В. Мастер создаст подкаталог приложения (ех0За в 
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каталоге \усрр№ео, а в нем ряд файлов. По окончании работы мастера посмот- 
рите на содержимое каталога приложения (табл. 3-1). 


МЕС Аррисанов \2ог 4 - екоЗа 


бепега{е4 С1аз$ез 
Вемем, депегаке с1а5ез апд зресФу Базе с!а5зез Гог усиг аррйсаНоп. 


Табл. 3-1. Важные файлы в подпапке приложения 


Файл Описание 

ЕхОЗа.узрго} Файл проекта, применяемый У15иа1 С++ МЕТ для сборки 
приложения 

ЕхОЗа.5 п Файл решения с единственной записью о проекте ЕхОЗа.узрго} 

ЕхОЗа.гс Текстовый файл описаний ресурсов 

ЕхОЗа\Ме\усрр Файл реализации класса «вид» с функциями-членами класса 
СЕхОЗаеи 

ЕхОЗа\\1е\/.В Заголовочный файл класса «вид», содержащий объявление 
класса СЕхОЗа"еи) 

ВеааМе. хи Текстовый файл с описанием назначения сгенерированных файлов 

Везоигсе.В Заголовочный файл, содержащий определения констант #а4ейте 


Откройте файлы ехОЗа\емусрр и ехОЗа\е\/В и взгляните на исходный код. 
В совокупности эти файлы определяют СЕхОЗаеи — главный класс приложе- 
ния. Объект класса СЕхОЗаеи» соответствует рабочему окну программы, где 
и происходят все «события». 
Выполните компиляцию и компоновку сгенерированного кода. Помимо 
генерации кода, МЕС Аррйсайоп \У/Л2агА создает для вашего приложения фай- 
лы проекта и рабочего пространства. Файл проекта ЕхОЗа.узрго} описывает все 
зависимости файлов, а также параметры компилятора и компоновщика. Так как 
новый проект становится текущим проектом У151а! С++ МЕТ, вы можете собрать 
приложение, выбрав ВиНа ЕхОЗа.ехе из меню ВийЙА или щелкнув кнопку ВиЙа 
на панели инструментов: 


Если сборка прошла успешно, в подкаталоге еБиз$ каталога \усррМе \ехОЗа 
создается исполняемый файл ехОЗа.ехе. Файлы ОВ] и другие промежуточные 
файлы также помещаются в каталог РеБи?. Сравните структуру каталогов на 
диске со структурой страницы 5ойоп Ехр/огег. 
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бошиоп Ехрюгег представляет логическую структуру проекта. Заголовочные 
файлы располагаются в разделе Неа4ег ЕЦез, хотя физически они хранятся в 
том же подкаталоге, что и файлы СРР. Файлы ресурсов хранятся в подкаталоге 
\гез. 
Протестируйте полученное приложение. В меню РеБиз выберите коман- 
ду мам \ирош РеБизае. Поэкспериментируйте с программой. Она мало на 
что способна, да? (А что вы хотели, не написав ни строчки кода?) На самом 
деле, как вы, вероятно, догадываетесь, у программы много возможностей — 
просто они еще не активизированы. Закончив эксперименты, закройте окно 
программы. 
Просмотрите исходные тексты программы. Нажмите СТЕГ+АГТ+), чтобы 
открыть окно ОБесе Вгоуузег. Если параметры проекта не требуют создания базы 
данных средства просмотра, \У15иа1 С++ МЕТ предложит изменить их и пере- 
компилировать программу. [Чтобы изменить параметры самостоятельно, вы- 
берите Ргорегиез в меню Рго]есг. Перейдите к папке С/С++, щелкните значок 
Вгоуузе погтаЧоп измените значение свойства ЕпаЫе Вго\узе югтаноп на 
АП Вгоуузе пРЮгтаНоп (/ЕВ).] 

Раскрыв ветви иерархии, вы должны получить резульгат, аналогичный пред- 
ставленному ниже. 
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ез0За - Мековой Уна! [+ + [дезю] _ Обуесе Веомзае 


Сак\модонрес ИРВЕСТ 1рСфепёВест, (ЛМТ пАФи: 


39$ САБООЮ 3® СМен(уов) 
9 САБОШЕОЮ:: _ иппатед_с07е9е9е_1 |. 2$ БоргерагеРипНпа(СРипЕлво *р1пРо) 
*Ф Боригёргемем( ИМТ п1ОВезоигсе, Сем *рРипё\ 
Ф Битр(СритрСогкехе &) сопзЕ . 
‘бебоситеп (мо) сопзЕ 
‘бе{МеззадеМар(уо9) сопзЕ 


‘беёрипётеСасз(уо) сопёЕ 
‘беЕбсгойВагСЬИ(тЕ пВаг) сопзЕ 
и (/0 


Сравните эти резульгаты с содержимым страницы С1!а$$ Мем: 


$ Меж е 


'Вазез ап 1пееГасех 
= Мару 

:%® АсзенмайЧ(уо) сопя: 

^СехоЗаМем( мо) 
{® сехозамемкуов) 
стезкеОБеск(уон) 
Фитр(СОитрСогкехЕ 84) сопяЕ 
‘беЮоситеп (мо) сопяЁ 
3 беилнтеСазз (мо) сопяЕ 
бете Сав$(у0 4) 
® опведприлело(СОС *рос, срипылго *руро) 
ОпОган(СОС *рос) 

$ ОПЕПЧРИЛИПО(СОС *рос, СРипЫпго *рулро) 

{48 ОпРгерагеРрипило(СРипетиво *рулРо) 
+ 24$ ргеСтеакеМИпао®(СВЕАТЕЗТВИСТ в) 
+. © Чаз5СехозаМему 


(а; Ме\м показывает иерархию классов почти так же, как ОБесЕ Вго\узег, 
но зато последний показывает все имеющиеся функции класса, а С1а5$ УЧе\м — 
только переопределенные. Если вам хватает С1а5$ У1еу, не трудитесь создавать 
базу данных браузера. 


Класс СЕхОЗаУГеи 


Класс СЕхОЗаеи сгенерирован МЕС АррИсайоп \У/12аг4 специально для прило- 
жения ЕхОЗа. (Мастер создает имена классов на основании имени проекта, задан- 
ного в его первом диалоговом окне.) СЕхОЗаеи находится в конце длинной це- 
почки наследования классов библиотеки МЕС, как видно в окне ОБесЕ Вго\узег. 
В классе собраны функции-члены и переменные-члены со всей цепочки. Сведе- 
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ния об этих классах см. в справочнике Мгозой Еоипаайоп С1а55 Ке/етепсе (в ин- 
терактивном или бумажном варианте), но обязательно просматривайте описания 
всех базовых классов, так как описания унаследованных функций-членов обыч- 
но не повторяются в производных классах. 

Важнейшие базовые классы вида СЕхОЗаеи — СУпа и СШеш. Спа придает 
СЕхОЗаеи свойства окна, а СИеш обеспечивает связь с остальными частями кар- 
каса приложения, в частности, с документом и рамочным окном, как вы увидите 
в главе 12. 


Рисование внутри окна представления: 
МЛпаом$ @0]| 


Теперь вы готовы к созданию кода, который будет рисовать в окне представле- 
ния. Вы внесете несколько изменений прямо в исходный текст ЕхОЗа. Конкрет- 
нее, вам понадобится наполнить реализацию Опртгаш в ЕхОЗа\1е\усрр и порабо- 
тать с контекстом устройства и интерфейсом СТ. 


Функция-член ОпОгаи/ 


ОпРгаш — это виртуальная функция-член класса СИеи», которую каркас приложения 
вызывает всякий раз, когда нужно перерисовать окно представления. Перерисов- 
ка требуется, когда пользователь изменил размеры окна или открыл ранее неви- 
димые его части, либо само приложение изменило данные окна. В первых двух 
случаях Оп)гаш вызывается каркасом приложения автоматически; однако если 
данные окна изменены функцией изнутри программы, эта функция должна уве- 
домить \Лп4о\$ об изменениях, вызвав унаследованную классом «вид» функцию- 
член ирайаше (или тоайашеКесь. Код тоайаже впоследствии вызовет Оита. 

Хотя внутри окна разрешается рисовать в любой момент времени, рекомен- 
дуется все же накапливать изменения и обрабатывать их «одним махом», вызвав 
функцию Опр лишь раз, — тогда программа сможет реагировать как на собы- 
тия, сгенерированные ею самой, так и на события, инициированные \/1190%5 
например, на изменения размеров окна. 


у 


Контекст устройства в МИпдом$ 


Как вы помните из главы 1, \Лп4о\з не допускает прямого доступа к аппаратуре 
дисплея, а взаимодействует с ней через уровень абстрагирования под названием 
контекст устройства (4еясе согиехи, связанный с окном. В библиотеке МЕС 
контекст устройства представлен объектом класса С++ с именем СОС, который 
передается.в Оп)гаш по ссылке (как указатель). Указатель на СОС позволяет за- 
действовать множество функций этого класса для рисования. 


Добавление кода рисования в программу Ех0За 


А теперь напишем код, отображающий в окне представления текст и круг. Убеди- 
тесь, что проект ЕхОЗа открыт в \15иа! С++ МЕТ. Чтобы найти функцию, можно 
воспользоваться С1а55 У1е\у (дважды щелкните Оп)таи) либо открыть исходный 
файл ехОЗа\е\усрр из Зошоп Ехрюгег и отыскать функцию в тексте. 
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. Отредактируйте функцию ОпОгаи в ех0ЗаУ1еуу.срр. Найдите в файле ЕхОЗа- 
Меусрр функцию Ои)гаш, сгенерированную МЕС АррИсайоп УЙгага: 


\014 СЕхОЗа\1ем: :Оп0гам(С0С* /* рос */) 
{ 
СЕхОЗабос» рбос = бетВосимеп{(); 
АЗЗЕВТ_\УАЕТО(р0ос); 


// 1000: а99 Чгам соде Рог паф1\уе дата пеге 


Удалите символы комментария с указателя на контекст устройства и заме- 
ните код на текст, выделенный полужирным шрифтом: 


\019 СЕхОЗа\1ем: :ОпОгам(СОС»* рб) 
{ 
роС->Техе0и{(0, 0, “Не11о, мог19а!”); // Вывод шрифтом по умолчанию 
// в левом верхнем углу 
роС->5е1ес5$ТоскОБ] ес+( 6ВАУ_ВВУЗН); // Выбрать кисть для заполнения круга 
роС->Е111рзе(СВес+(0, 20, 100, 120)); // Нарисовать серый круг 
// диаметром 100 единиц 


Вызов Сеоситет можно спокойно удалить, поскольку пока мы не рабо- 
таем с документами. Функции 7ехЮиь 5еесбюсвОБес и Ейрзе — члены клас- 
са контекста устройства СОС каркаса приложения. Функция ЕШр$е рисует круг, 
если длина ограничивающего прямоугольника равна его ширине. 
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Для работы с прямоугольниками \/п4о\з библиотека МЕС предоставляет 
удобный класс СКес!. Временный объект СКес! — аргумент, ограничивающий 
прямоугольник для функции рисования эллипса. Класс СКесё будет часто встре- 
чаться в примерах этой книги. 

2. Скомпилируйте и оттестируйте Ех0За. Выберите команду Вий4 из меню 
ВИНА и, если нет ошибок компиляции, снова запустите программу. Теперь видно, 
что ваша программа кое-что да умеет! 


Первое знакомство с редакторами ресурсов 


Теперь у нас есть готовая программа — самое время познакомиться с редактора- 
ми ресурсов. Хотя файл ресурсов приложения ЕхОЗа.гс — текстовый А$СП-файл, 
изменять его в текстовом редакторе — не лучшая идея: для этого существуют ре- 
дакторы ресурсов. 


Что содержит файл ЕхОЗа.гс 


Файл ресурсов во многом определяет внешний вид и поведение приложения ЕхОЗа. 
Он содержит (или указывает на) ресурсы УИЛпао\у$ (табл. 3-2). 


Табл. 3-2. Ресурсы \Иптдоми$ в МЕС-приложении 


Ресурс Описание 
«Быстрая клавиша» (Асс@егатог) Задает клавиши, нажатие на которые эквивалентно 
выбору элементов меню и кнопок панели управления. 


Диалоговое окно (012102) Определяет формат и содержимое диалоговых окон. 
В ЕхОЗа есть только диалоговое окно АБоие («О про- 
грамме»). 

Значок ([соп) Значки (версии 16Х16 и 32Х32 точки), аналогичные 


значкам приложений, которые отображаются в Про- 
воднике (\Лпао\з Ехрюгег) и в диалоговом окне 
АБоц( приложения. В качестве значка приложения 
ЕхОЗа используется логотип МЕС. 


Манифест (Маш е$0) Содержит информацию о типах времени исполнения 
для приложения. 


Меню (Мепи) Меню верхнего уровня приложения и связанные 
с ним раскрывающиеся меню. 


Таблица строк (Зе гае) Строки, не являющиеся частью исходного кода С++. 
Панель инструментов (Тоофаг) Ряд кнопок непосредственно под меню. 
Версия (Уег1оп) Описание программы, номер ее версии, язык и т. д. 


Кроме перечисленных ресурсов, ехОЗа.гс содержит операторы: 


{1ис1иде “аРхгез.Н” 
#1ипс1иде “аРхгез. гс" 


Они подключают некоторые ресурсы библиотеки МЕС, общие для всех при- 
ложений. В их числе строки, графические кнопки и элементы, необходимые для 
печати и ОГЕ. 


ГЛАВА З Знакомство с мастером создания МЕС-приложения 37 


——[——ыыыы—ы—=—=—=—=ы—=—=—=—ы=ы=3—_—_ 


ААА АСВ 
Примечание Если вы используете МЕС в виде совместно используемой РШ-- 
библиотеки, общие ресурсы хранятся в самой ОМ, МЕС. 


Файл ех0За.гс также содержит оператор: 
Нос1иде “гезоигсе. п" 


который вводит в приложение три константы #4ейте: [РК_МАПУЕКАМЕ (опреде- 
ляет меню, значок, таблицы строк и «быстрых клавиш»), /ОК_ЕХОЗАТУРЕ (опреде- 
ляет значок документа по умолчанию, однако в этой программе мы его не исполь- 
зуем) и [РО_АВОИТВОХ (идентификатор диалогового окна АБоио. Этот же файл 
гезомгсе.В неявно включается исходными файлами приложения. Если средствами 
редактора ресурсов добавить другие константы (символы), то их определения в 
конечном счете попадут в гезочгсе.п. Будьте внимательны, редактируя этот файл 
в текстовом редакторе: внесенные вами изменения могут быть удалены, когда вы 
в следующий раз используете редактор ресурсов. 


Работа с редактором диалоговых окон 


Редактор диалоговых окон служит для создания и редактирования ресурсов диа- 
ЛОГОВЫХ ОКОН. 


1. Откройте ВС-файл проекта. В меню \1е\ выберите команду Кезоигсе У1еуу. 
Раскройте узлы — вы должны увидеть следующее: 


2. Изучите ресурсы приложения. Если выбрать ресурс двойным щулчком, от- 
крывается другое окно с набором инструментов, соответствующих данному ре- 
сурсу. Открыв ресурс диалогового окна, вы увидите палитру элементов управ- 
ления. Если она не появилась, выберите в меню \1е\/ команду Тоорох. 

2. Измените диалоговое окно ОО_АВОЗТВОХ. Внесите небольшие измене- 
ния в представленное ниже диалоговое окно АБоцё. 

Вы можете изменить размер окна, двигая мышью его правый и левый края, 
переместить кнопку ОК, изменить текст и т. д. Просто выделите элемент щел- 
чком, а затем, щелкнув правой кнопкой, измените его свойства. 


3—2064 
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4. Заново соберите проект с измененным файлом ресурсов. В У15иа! С++ 
„МЕТ в меню ВиЙ4 выберите команду Ви!а ЕхОЗа.ехе. Кстати, перекомпилиро- 
вать код С++ не понадобится. У15иа| С++ МЕТ сохранит отредактированный файл 
ресурсов, затем компилятор ресурсов (гс.ехе) обработает ЕхОЗатс и создаст 
скомпилированный вариант ЕхОЗа.гез, который передается компоновщику, 
Последний выполнит свою задачу быстро, так как в данном случае ему доста- 
точно скомпоновать лишь изменения. 

5. Протестируйте новую версию приложения. Снова запустите программу 

ЕхОЗа, в меню Нер выберите команду АБоцг и убедитесь, что ваши изменения 

видны в диалоговом окне. 


Конфигурации ОеБид и Вееазе 


При сборке приложения вы вправе выбрать один из двух вариантов конфигурации 
приложения: отладочный (РеБиз) или окончательный (Ке!еа5е). При генерации 
нового проекта МЕС АррИсацоп УЯтага создает одну из конфигураций (табл. 3-3). 


Табл. 3-3. Параметры, определяемые МЕС АррИсаНоп \МИгхаг4 по умолчанию 


ИННА ААА ВЕ 
Параметр Окончательная сборка (Ве!еазе) Отладочная сборка (БеБид) 
Отладка по Отключена Включена для компилятора 
исходному тексту и компоновщика 
Диагностические Отключены (определен МРЕВИС) Включены (определен 
макросы МЕС _ВЕВИС) 

Библиотеки Рабочие библиотеки МЕС Отладочные библиотеки МЕС 
Оптимизация Оптимизация по скорости Без оптимизации 

при компиляции (в Геаглил8 ЕЧюп отсутствует) (ускоренная компиляция) 


Разработка приложений ведется в режиме отладочной сборки (РеБие тоде), 
а перед поставкой программа собирается заново в режиме окончательной сбор- 
ки (Ке!еазе то4е). Исполняемые файлы, собранные в режиме Ве!еазе, характери- 
зуются меньшим размером и работают быстрее. Текущая конфигурация выбира- 
ется из списка в окне ВийА (рис. 1-2 в главе 1). По умолчанию результаты и про- 
межуточные файлы сборки проекта в отладочном режиме, хранятся в подпапке 
Рериз, а файлы для окончательной сборки — в подпапке Ве!еазе. Вы вправе задать 
другие каталоги на странице свойств Сепега! папки Сопйзиганоп Ргорегиез, до- 
ступной в диалоговом окне свойств проекта. 

Вы можете создавать собственные конфигурации, выбрав в меню Вий команду 
Сопйгигайоп Марпаесег. 


Предкомпилированные заголовочные файлы 


При создании проекта МЕС АррИсаНоп \/12ага генерирует параметры и файлы, 
необходимые для предварительной компиляции заголовочных файлов. Для эффек- 
тивного управления проектами нужно знать, как работают иредкомпилированные 
заголовочные файлы (ргесотр!еа Беадег). 
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Примечание В У!5иа1 С++ .МЕТ два «режима» предкомпиляции заголовочных 
файлов: автоматический и ручной. При автоматической (амотаЧНс), 
активизируемой параметром командной строки компилятора /Ух, резуль- 
таты работы компилятора сохраняются в файле «базы данных». Предком- 
пиляция вручную (тапиа!) активизируется параметрами компилятора /Ус 
и /Ум. Созданные при этом заголовочные файлы применяются в проск- 
тах, сгенерированных МЕС АррИсайоп \/2аг4. 


Предкомпилированные заголовочные файлы представляют собой «моменталь- 
ные снимки», которые делает компилятор на определенной строке исходного 
текста. В МЕС-программах такой снимок обычно делается сразу после оператора: 


#1пс1и0е “зфдатх. п” 


Файл 5{ААЕх.В содержит операторы #тсшае для заголовочных файлов библио- 
теки МЕС. Содержимое файла зависит от выбранного режима МЕС АррНсайоп 
УЛ1тага, однако в нем всегда есть операторы: 


#1пс1и9е <аРхм1п. п> 
#1пс1и4де <афхех+. п> 


Если в приложении применяются составные документы, 5{ЧАЁх.В также содер- 
жит строку: 
Нис1иде <аРхо1е. п> 


А если вы работаете с Амотаноп или элементами управления АсиуехХ, он со- 
держит: 


#1пс1иде <афха1$р.п> 


Если же вы используете Ииегпе! Ехр!огег 4 Соттоп Сопиго[5, то 5ААЕХ.В со- 
держит 


#1пс1и49е <атхафст1. п> 


Вам могут потребоваться и другие заголовочные файлы. Так, заголовочный файл 
для классов наборов на основе шаблонов подключается оператором: 


#11пс1иде <аРхфетр1.п> 


В файле $АЁх.срр содержится единственный оператор: 


Н1пс1и4де “ЭтаАТх. п" 


Он-то и используется для генерации файла предкомпилированных заголовоч- 
ных файлов. Заголовочные файлы библиотеки МЕС, включаемые в файле 5{4АЕХ.В, 
никогда не изменяются, но их компиляция требует времени. Параметр компиля- 
тора /, используемый только для 5ААЁх.срр, вызывает создание предкомпили- 
рованного заголовочного файла (с расширением .рсп). Параметр /и, применяе- 
мый для остальных исходных файлов, вызывает использование существующего 
РСН-файла. Для определения имен РСН-файла применяется параметр /Ёр. В отсут- 
ствие этого параметра в подкаталоге результатов текущей конфигурации создает- 
ся файл с именем проекта и расширением РСН. Весь процесс показан на рис. 3-1. 
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/Ус'айх. п" /Уш"4дафх. п" 


/Ер <путь> определяет путь файла 


Рис. 3-1. Процесс генерации предкомпилированных заголовков 


АррУЙлгаг4 автоматически генерирует параметры /Ж и /Уи, но вы вправе вне- 
сти коррективы. Можно задавать параметры компилятора для отдельных исход- 
ных файлов. Если в диалоговом окне свойств проекта (Ргорему Рабез) на страни- 
це РгесотрЦеа Неа4егз папки С/С++ выбрать только файл 1ААЕХ.В, вы увидите 
параметр /Ж, который переопределят параметр „Ум, заданный для всего проекта. 

Учтите: РСН-файлы достаточно объемны — в среднем около 10 Мб. Если сними 
обращаться неосмотрительно, жесткий диск может быстро переполниться. Реко- 
мендустся периодически очищать каталоги РеБиз своих проектов или же разме- 
щать все РСН-файлы в одном каталоге, определяя параметр компилятора /Ер. 


Два способа запуска программы 


У15иа! С++ МЕТ позволяет запускать программу непосредственно (нажав клавиши 
Си+Е5) или в отладчике (клавиша Е5). Непосредственный запуск выполняется 
гораздо быстрее, так как \У15иа1 С++ МЕТ не требуется предварительно загружать 
отладчик. Если вам не нужны трассировочные сообщения и точки останова, за- 
пускайте программу с помощью Си1+Е5. 


ГЛАВА 


Мастера \зца! С++ .МЕТ 


НЬы разработке программ для операционных систем М1сгозой приходится пи- 
сать много шаблонного кода. На заре \УЛп4о\5 большинство программистов на- 
чинало разработку \Лп9о\/з-приложения, вооружившись лишь книгой Чарльза Пет- 
цольда (Свашез Ре2о1А) «Ргозгатит? УЛп4о\/з» и комплектом разработчика ХЛ1шп- 
4о\$ зой\маге Реуеюртепи Ки (50К). Даже в документации УЛш9оу/$ $0К реко- 
мендовался метод разработки с широким использованием унаследованного кода. 

Чтобы разобраться с основами любой технологии, надо самостоятельно напи- 
сать весь код приложения. Но наступает момент, когда написание однообразного 
шаблонного кода перестает быть упражнением и превращается в рутину и пус- 
тую трату времени. В М!сгозой У15ча1 5га@ю „МЕТ эту проблему решает встроен- 
ный набор генераторов кода, облегчающих создание проектов любого типа. До- 
ступные шаблоны проектов отображаются в окне Мех Рго]ес+, открывающемся при 
последовательном выборе команд М№е\ и Рго]есЕ в меню ЕЦе. Вам достаточно вы- 
брать шаблон проекта, пробежать несколько диалоговых окон конфигурирования 
проекта и щелкнуть кнопку Е158. Вуаля — у вас работающее приложение! 

Но это еще не все. Технология мастеров открыта — вы вправе писать собствен- 
ные мастера. В этой главе вы узнаете, как это делается в У!15иа1 $а41ю „МЕТ. 


Типы мастеров 


В У!5ща| бгаЧю „МЕТ два типа мастеров: с пользовательским интерфейсом и без — 
все определяется сложностью мастера и желанием автора. Большинство описан- 
ных в этой книге мастеров относится к первому типу. Например, МЕС АррИсаНоп 
УЛгага состоит из нескольких страниц, на которых определяются такие парамет- 
ры, как тип интерфейса (50Г или МОП), необходимость поддержки печати и пред- 
варительного просмотра, а также применения элементов управления Асцуех. В не- 
которых простых приложениях пользовательский интерфейс не нужен. 
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В мастерах без пользовательского интерфейса достаточно определить назва- 
ние проекта — файлы проекта создаются в соответствии с выбранными шабло- 
нами. Мастера с пользовательским интерфейсом более интерактивны и часто 
состоят из нескольких страниц. 

В сущности исходный код всех мастеров У15иа1 С++ МЕТ доступен — его вы 
найдете в каталоге \Ргозгат ЕЦез\Мисгозой У15иа1 Зи ю МЕТ\УС7\УС\лага$. 


Как работают мастера 


Сначала мы узнаем, как работают мастера, и познакомимся с тремя основными 
компонентами мастера: исходным шаблонным кодом, пользовательским интер- 
фейсом и результирующим (сгенерированным) кодом. 

Главная задача генератора кода — избавить вас от написания шаблонного кода. 
Это может быть вполне рабочий и поддающийся компиляции «скелет» приложе- 
ния или библиотеки. Однако код должен решать основную задачу проекта. Напри- 
мер, при написании приложения, которое создает платежные ведомости, имена 
классов должны иметь внятные названия, скажем, СРаутоЙОос (документ платеж- 
ной ведомости), СРаутоеи (просмотр платежной ведомости) или СРаутойЕтате 
(окно-рамка платежной ведомости). В числе прочего в обязанности мастера вме- 
няется присвоение шаблонным классам простых понятных имен, вводимых раз- 
работчиком. 

Мастер позволяет добавлять или отбрасывать отдельные части исходного кода. 
Так, если на странице мастера установить флажок диалогового окна АБоиь, мас- 
тер добавит исправленный код соответствующего окна в конечное приложение. 

Выбор вариантов реализуется в пользовательском интерфейсе мастера. Серд- 
це интерфейса мастера — НТМГ-элемент управления Г/СИЙ2СИИЛ. По сути пользо- 
вательский интерфейс мастеров У15а! $ тю МЕТ написан на языке НТМ!. Во время 
работы мастера ГИУССИИЛ находит и отображает файлы пользовательского 
интерфейса в окне мастера. Мастер отвечает за навигацию по страницам и гене- 
рацию кода по щелчку кнопки Е!115В. 

Число страниц мастера не ограничивается, причем каждая страница — это 
отдельный НТМГ-файл. Для перемещения между страницами мастера служат кнопки 
Мехг и Васк (впрочем, вы вправе организовать и иной порядок перемещения). 
НТМГ-файлы пользовательского интерфейса содержат тэг 5УМВОЕ, который опи- 
сывает значения по умолчанию для определяемых разработчиком параметров. 

Мастер поддерживает таблицу символов на протяжении всего времени своей 
работы. Таблица символов служит для выполнения подстановок. Объявленные в 
НТМГ-файле символы по щелчку кнопки Еи!5В записываются в таблицу симво- 
лов. Вот пример НТМГ-кода мастера: 


<ЗУМВОЕ МАМЕ=” ЗОВСЕ_РТЕЕ’ МАГОЕ=’ Мубоигсе. срр’` ТУРЕ={ех{></ЗУМВОЕ> 


В пользовательском интерфейсе мастера текстовое окно служит для ввода 
информации пользователем. Идентифицируется текстовое окно символом 5О0К- 
СЕ_ЕШЕ. Это ключевой символ, который мастер применяет при подстановке в 
исходных файлах. Сейчас вы узнаете, как это работает. По сути каждый НТМГ-файл 
мастера записывает выбранные пользователем варианты в таблицу символов. 
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Внутренняя логика мастера обычно базируется на ]5сийр:. При необходимос- 
ти особого поведения мастера для доступа к модели У1$иа1 С++ УЛгагА можно 
использовать функции ]5сирь, которые размещаются на НТМГ-странице в разде- 
ле <5СМРТ ГАМСИАСЕ= ]5СЫРТ>. 


Примечание Подробнее о модели мастеров У15ща1 С++ УЛлагА и других объек- 
тных моделях, составляющих расширяемую объектную модель У151а1 С++ 
ЕжепярИщу Оесе Моае|, см. библиотеку М$ОМ. 


Создание мастера 


Первый шаг при создании мастера — написание и отладка шаблонного приложе- 
ния. Затем средствами \154а! С++ „МЕТ создается «чистый» мастер. В состав У151а1 
Уиаю .МЕТ включен мастер Сихот УЛгага, применяемый для создания мастеров. 
Он генерирует все файлы, необходимые для реализации мастера. 

Чтобы создать мастер, последовательно выберите команды Ме\ и Рго}есё в меню 
ЕЦе, в открывшемся диалоговом окне выберите папку У151а1 С++ Рго]ес:$ и шаблон 
Си5от \/12ага. Введите имя мастера в поле Мате. Сизтот \/12агА состоит из двух 
страниц: обзорной (Оуег\еу)) и страницы параметров АррИсайоп 5е 1$. Послед- 
няя позволяет определить понятное имя и количество страниц в мастере, а также 
указать, должен ли у мастера быть пользовательский интерфейс. Мастер Сизют 
УЛгага создает несколько файлов (табл. 4-1). 


Табл. 4-1. Файлы, создаваемые мастером Сизют МЛгага 


Файлы Описание 

Рго]есё.\$2 Тестовый файл ядра мастера. Предоставляет информацию 
о контекстных и дополнительных (необязательных) 
параметрах. 

Ргоесеуз ах Тестовый файл сервиса маршрутизации между оболочкой 
\У151а1 $04410 и элементами в проекте мастера. 

НТМЕ-файлы Файлы, реализующие пользовательский интерфейс мастера. 

(при необходимости) Для мастеров без пользовательского интерфейса НТМГ-файлы 
не нужны. 


Если мастер состоит из одной страницы, создается файл 
Реаи.Бит. В противном случае дополнительные страницы 
называются Разе_<номер_страницы>. вит. 


Файлы сценариев Логика работы мастера заключена в сценариях. Для каждого 
проекта в мастере создаются файлы ]5сийрЕ с именами РеЁаиц.}з 
и Соттоп.]з. Они содержат ]5сирг-функции, применяемые для 
доступа к моделям У154а1 С++ УЛгага, Соде, Рго]есь, и Везоигсе 
Еайог и тонкой настройки мастера. Добавляют и настраивают 
функции в файле проекта мастера РеЁаи.}з. 


Шаблонные файлы Набор текстовых файлов с директивами в каталоге Тетр!а(ез. 
Файлы анализируются и вставляются в таблицу символов со- 
гласно выбранным пользователем параметрам. Соответствую- 
щую информацию получают путем прямого доступа к таблице 
символов относящегося к мастеру элемента управления. 


см. след. стр. 
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Табл. 4-1. (продолжение) 


Файлы Описание 


Тепар!аиезлюЁ Текстовый файл со списком всех относящихся к проекту шаб- 
лонов. 

Реаиусрго} ХМЕ-файл, содержащий сведения о типе проекта 

бапр!е. хе Шаблонный файл, показывающий, как использовать директивы 
мастера. 

ВеааМе. хе Шаблонный файл, содержащий информацию обо всех файлах, 


созданных мастером Сизот \/12ага. 


Файлы изображений — Файлы изображений — значки, СЛЕ-файлы, ВМР-растры и дру- 

(при необходимости) гие поддерживаемые в НТМГ, форматы. Служат для «украшения» 
интерфейса мастера. Понятно, что в мастере без пользовательс- 
кого интерфейса файлов изображений не нужно. 


517165.с$$ Файл, определяющий стили пользовательского интерфейса. 
(при необходимости) Если пользовательского интерфейса нет, мастер Сизот \У/хага 
не создает С$55-файл. 


Соттоп.]}5 Набор ]5сире-функций, используемый всеми мастерами. На са- 
мом деле этот файл мастером Сизот УИ таг не создается — он 
просто добавляется в результирующий код. 


Создание мастера для разработки 
М!еБ-приложений на управляемом С++ 


Сейчас вы научитесь создавать мастер приложения генерирующий \Ж’еБ-приложе- 
ние с применением АЗР.МЕТ и управляемого С++. Подробнее о написании прило- 
жений на основе \еБ Рогпл$ с использованием АЗРМЕТ и управляемого С++ вы 
узнаете во второй части книги. А пока мы создадим мастер приложения, генери- 
рующий приложение на основе \/еЬ Роги. При этом надо создать ряд файлов, а 
также неплохо предусмотреть трассировочные и отладочные сообщения, несколько 
управляющих элементов разных типов, чтобы наглядно познакомиться с работой 
мастера. Для приложения на основе \еЬ Еоги$ следует создать несколько фай- 
лов: файлы исходного кода ОИ-библиотеки на управляемом С++, файлы АЗРМЕТ 
(А5РХ), файл \еБ.Сопй$ и файл решения У150а! $на 10. В каждом из этих файлов 
надо предусмотреть возможность подстановок, выполняемых мастером приложе- 
ния после получения входных данных от пользователя. 

Мы создадим мастер с помощью Сизют \/т7ага и назовем его Мапавеасеь- 
Еотт тата. Чтобы процесс был понятнее, мы будем создавать мастер с одной 
страницей, но в своем мастере вы вправе создать сколько угодно страниц. 

Сам пользовательский интерфейс будет содержать флажки, позволяющие до- 
бавлять элементы управления, включать/отключать отладочные и трассировочные 
сообщения. бойоп Ехр!огег позволяет посмотреть на НТМ!-страницу пользова- 
тельского интерфейса мастера. Редактирование этой страницы похоже на редак- 
тирование стандартных диалоговых окон: элемент управления выбирается на ин- 
струментальной панели Тооох в левой части окна \!15ца| Знаю МЕТ и перено- 
сится на страницу, затем ему присваиваются свойства в окне Ргорегиез. На стра- 
нице мастера 6 флажков. Три флажка управляют добавлением трех элементов 
управления в \Ь Рогт: флажка (СвескКВох), надписи (ТаБе!) и текстового поля 
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(ТежВох). В окне Ргорегие$ определяются названия каждого из элементов. Фла- 
жок называется Изе1ехВох, надпись — ИзеГаре!, а текстовое поле — ИзеСресЁВох. 
Во время генерации кода мастер отыскивает эти символы и добавляет соответ- 
ствующий код в АЗРХ-файл и текст страницы. 

Остальные три флажка позволяют управлять отладкой: первый служит для трас- 
сировки страницы, другой — для трассировки по запросу, третий — для включе- 
ния отладки. Идентификаторы флажков — ИзеРавеТгаств, ИзеКедиегаств: и 
ОзеРаверериротив. Как и в случае со страницей пользовательского интерфейса, ма- 
стер ищет эти символы и добавляет соответствующий код в создаваемый проект. 
На рис. 4-1 показана страница мастера — файл РеЁаиИ.Бит — в действии. 

} \Ууесоте {о 'Мападедс\У/е РоптАрр\УЙхаг4' 
|}  Стеаце \№еб Рогт ивтд Мападед С++ 


Рис.4-1. Страница пользовательского интерфейса мастера 
МапазеаС\’е Е огл УЛ лага 


Размещенные на странице элементы управления следует сопоставить с сим- 
волами, которые мастер будет применять для подстановок. Исходная страница 
пользовательского интерфейса мастера (аеЁаи.Б ит) содержит группу записей о 
символах. Измените символы мастера \еБ-приложения так: 


<ЗУМВОЕ МАМЕ=“ИзеСпескВох” ТУРЕ=“спескрох” МАШЕ=“Ра1зе"></5ЗУМВОЕ> 
<ЗУМВОЕ МАМЕ=“ИзеТехтВох” ТУРЕ=“спескрох” \УАШИЕ=”Та1 зе” ></ЗУМВОЕ> 
<ЗУМВОЕ МАМЕ=“Узетаре1” ТУРЕ=“спескрох” \УАШЕ=“Ра1зе"“></5УМВО> 

<ЗУМВОЕ МАМЕ=”ИзеРадеТгас1пд” ТУРЕ=“”спескоох” МАШЕ=”Ра1е"></ЗУМВОЕ> 
<5УМВОЕ МАМЕ=“”ИзеВедиез{Тгас1пд” ТУРЕ=“спескрох” \МАШИЕ=“Ра1зе"></ЗУМВОЕ> 
<ЗУМВОЕ МАМЕ=”/зеРаде0еби991п9” ТУРЕ=“спескрох” МАШЕ=“”Ра1зе“></зУМВОЕ> 


Заметьте: символы сопоставляются отдельным флажками на странице пользо- 
вательского интерфейса мастера. 

Далее надо взять исходный код и вставить примечания с тех местах, где мас- 
тер должен добавлять другой код. Готовый шаблонный код хранится в каталоге 
Теглр!а(е$ мастера. В конечном варианте МапавеяС\е Еотт должен содержать три 
файла: заголовочный файл с классом С++, АЗРХ-файл с информацией о разметке 
У7еБ-страницы и файл \еБЬ.Сопй® с конфигурационными параметрами. Шаблон- 
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ные коды всех этих файлов будут располагаться в каталоге Тетр!а(ез мастера. 
Познакомимся с шаблонным кодом, используемым мастером для создания при- 
ложения. Вот код заголовочного файла С++: 


// МападеасмевРогт. в 
#ргадта опсе 


(3119 памезрасе Зузтет; 
#15119 <Зузтфет. 011> 
#18119 <Зузфет. Мер. 911> 


($119 патезрасе Зузфет; 

($119 патезрасе Зузфет: :Меь; 

($119 патезрасе Зузфет: :Меб: : ОТ 

($119 памезрасе зузтет: : меб: : ОТ: {МебСопго13з; 
($119 патезрасе Зузтет: :Со011ес110пз; 

(5119 патезрасе Зузфет: :Сотропеп{Моде]1 ; 


патезрасе Ргод\/5ЗМЕТ_МападедСмевРогт 
{ 
риуб11с __9С с1аз$$ МападедСмебРаде : риб11с Раде 
{ 
риб11с: 
Витфоп» м_БиЕТоп; 


[11е Узегабе1] 
[абе1* м_1абе]; 
[! еп91+] 
[!11Е УзеТехеВох] 
ТехеВох» т_Тех+; 
[!еп911] [11+ УзеспескВох] 
СпескВох» т_спеск; 
[| епа1 1] 


МападедСмебРаде() 
{ 


// Здесь вставляется код конструктора... 


\019 Зибт1{Ептгу(06]ест* о, Емеп{Агодз* е) 
{ 
// Вызывается по щелчку кнопки Зибт1е 


// Здесь вставляется код, исполняемый при загрузке страницы. .. 
5Ег1п9* ЭГ 


г = пем 51г1п9(“Не110о “); 
$Ёг = $1г->Сопса*($1г, м_фех{->дет_Тех*()); 
г = $1г->Сопса*($1г, пем $41г1п9(” уои ризпед Зибтат")); 


[117 УзеЁабе1] 
т_]абе1->зет_Техе(${г); 
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[111 Узегаре1] 
} 


\014 Раде_1оа9(063)ест* о, Еуеп{Агд$* е) 
{ 
// Здесь вставляется код, исполняемый при загрузке страницы... 
[111 УзеРадеТгас1т9] 
Тгасе->\г11е("Сизфот", "Тпз14е Раде_1оад”); 
[!еп911] 
11(!Т5Роз{Васк) { 
} 


| 


При генерации кода мастер ищет ключевой символ, заключенный в квадрат- 
ные скобки, и проверяет его наличие в таблице символов. В нашем примере это 
простые булевы выражения. Если флажки установлены, значит, надо включить 
соответствующие элементы управления или отладочные сообщения. Иначе соот- 
ветствующий код следует «выкинуть» из создаваемого кода. Аналогично следует 
обработать все создаваемые файлы. Например, мастер возьмет следующий шаб- 
лонный код страницы АЗРМЕТ, проверит вхождение символов ИбеКедиезИгаств, 
ОсетемВох, Изераре! и ИзеСресЕВох и решит, какой код присоединить: 


<*@ Раде Гапдиаде=“С#” 
[11г УзеНедиез{Тгас1п9] 
Тгасе={гие 
[!еп911] 
Тпнег1*з="Ргод\УЭМЕТ _МападеаСмебРогт. МападеаСмебРаде” 
%> 


<пт1> 

<роду> 

<Гогт гипаф=5егуег> 
<12>АЗР. МЕТ Меб Рогт</п2> 


<бг><6г><г> 


<азр:Ви{фоп Тех{=“Зит1е Епфгу” 19="т_бифоп” 
ОпС11ск="Зиби1Епегу” гипаф=зегуег /><6г/> 


<азр:[абе1 Тех{=”Туре уоиг пате пеге” гипаф=зегмег /> 


[11Е УзеТех{Вох] 

<азр:Тех{Вох 149="п_Техт” гипат=зегуег /><6г/> 
[!еп911] 
[11+ УзеСпескВох] 

<азр:СпескВох 19="пт_спеск” гипаф=зегуег /> <6г/> 
[!еп9] 
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[!1е УзеЁаБе1] 
<азр:[абе1 19=“м_1абе1” гипаф=зегмег /> 
[!еп91Е] 


</Рогт> 
</боду> 
</пт1> 


Последним создается файл \еБ.Сопйз — ХМГ-файл, используемый в АЗРМЕТ 
для конфигурирования \еБ-приложения. Здесь трассировка и отладка на уровне 
страницы включаются/выключаются в зависимости от состояния флажков: 


<соп1дига{10оп> 
<зузфет. меб> 
[111 УзеРадедеби991п9] 
<сотр11а{10оп. дерид=’ гие’ ></сотра1а{10оп> 
[! еп91Е] 
[117 УзеРадеТгас1т9] 
<{гасе епаб1ед=’ гие’ ></{гасе> 
[!еп911] 
</зузтет. меб> 
</соп1д9ига+10оп> 


Кроме шаблонного кода, мастер также должен знать, какие файлы добавлять в 
создаваемый проект приложения. Каталог Тетр!аез содержит файл Тетр!ез Е 
со списком создаваемых файлов. Файл Тетр!аез1п{ указывает мастеру, какие файлы 
должны содержаться в конечном проекте. Мы добавим в него записи о файлах 
Мапазеас\еЬЕогт.срр, Мапазеас\/еБЕогт.В, Мапазеас\/еЕогт.азрх и ЖеБ.сопйе. 
Этот файл работает так же, как и описанные до этого: мастер проверяет символы 
в таблице символов и генерирует приложение в зависимости от выбора, сделан- 
ного пользователем на странице интерфейса. В процессе создания проекта код 
сценария вызывает функцию СеЙатзей\ате, чтобы изменить имена базовых файлов 
(МапазеаС\е6Еогт.азрх, МапазеаС\еЬЕонт.срр и Мапазеа\еЕогт.В) в соответ- 
ствии с именем проекта, заданным пользователем при запуске мастера. Здесь по- 
казан модифицированный метод Се(Тагае\ате, который заменяет имена файлов. 


Гипсф1оп @е{ТагдетМате ($+гМате, з&гРгозес{Мамте) 
{ 

гу 

{ 


уаг з{гТагдет = з+гМаме; 


11 ({гГМате. зиб$тг(0, 15) == "МападеасмебРогт” ) 
{ 
уаг з{г1еп = з{гМаме. 1епдтн 
зЕгТагдет = $+гРго]естМате + э1гМаме. зи6$1г(15, $+г1еп -.15); 
} 
гефигп з{гТагдет; 
} 
сафсп(е) 
{ 
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Игом е; 


После создания файлов мастер на их основании создает проект. Сценарии 
создания проекта размещены в подкаталоге сценариев проекта мастера. Исход- 
ный сценарий, сгенерированный мастером Сизот У/хага, содержит метод Ааа- 
Сопйр. Объектная модель проектов в \151а1 5 о МЕТ позволяет изменять кон- 
фигурацию сгенерированного проекта. Далее следует исходный код, который 
устанавливает переключатель О1Т-библиотеки и генерирует управляемую сбор- 
ку. (Об управляемом коде см. часть 6). 


Рипст1оп А99Соп{19(рго], зЕгРго)есМаме) 
{ 
гу 
{ 
уаг соп!19 = рго). 06) ест. Соп1дига*10оп$(‘ Вебид?’) 
соп{19. Тптегтед91а{е01гесфогу = ’Берид’; 
соп+19.Оифри{01гестогу = ’Вебид’; 


соп{19.Соп1дигат1опТуре = фуребдупам1сЕ16гагу; 
уаг 011001 = с0п119. Т001$(‘ УССЕСотр11егТоо1”); 
// 1000: АЧЧ сомр11ег зе{{1п9$ 
СЕТоо1.Сотр11еА$Мападед = тападедАззеть1у; 


уаг Е1пКТо01 = соп{19. Т001$(‘ УСЕ1пкегТоо1”); 
// 1000: Ада 11пкег зе{т1п9$ 


с0п{19 = рго). 06] ест. СопР1дигат1опз( ‘ Ве1еазе’); 
с0п{19. Тлтегтед1ате01гестогу = 'Ве1еазе’; 
соп{Р19.Ои{ри{01гесфогу = 'Ве1еазе’; 


уаг СЕТоо]1 = соп{19. Т001$( ' УССЕСотр11егТоо1 ’); 
// Т000: АЧ9 сотр11ег зе1{1п9$ 
СЕТоо1.Сотр11еА$Мападед = тападедАзетб1у; 


уаг 11пКТо0] = соп{19:Т001$( ' УСЕ1пкегТоо1°); 
// 1000: АЧа 11пкег зе{{1п9$ 

} 

сатсп(е) 

{ 


игом е; 


Мы должны позаботиться о том, чтобы У15иа1 За о „МЕТ «узнала» о существо- 
вании созданного мастера. Для этого нужно разместить его в отдельном подката- 
логе каталога \Ргоргат ЕЦез\Мисгозой У15иа! $ ю МЕТ\УС7\УСУЛгага5. Файлы 
пользовательского интерфейса размещаются в подкаталоге НТМГ, файлы шаблон- 
ного кода — в подкаталоге Тетр!а{ез, файлы изображений — в подкаталоге Ипазез, 
файлы сценариев — в подкаталоге $сп1р!5. Все эти подкаталоги хранятся внутри 
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(на уровень ниже) каталога мастера. Файлы пользовательского интерфейса и 
шаблонные файлы можно локализовать. Файлы УЗР\В, У52. и значок размещают- 
ся в каталоге \Ргоргат ЕЦез\М!сгозой У15иа1 $еа о МЕТ\УС7\УСРго}еси. Как уже 
говорилось, файлы УЗОТВ и \52. генерирует мастер Сизют У/гага. 

Модель мастера приложений в У15иа1 5иЧю „МЕТ достаточно гибка и богата 
функциями. Мы рассмотрели только подстановку, определяемую состоянием флаж- 
ков. Существует множество других путей создания мастеров приложений для ге- 
нерации самых разных приложений. По сути архитектура нашего мастера пока- 
зывает, как реализованы другие мастера У151а1 Зо „МЕТ: АТ Зиаре ОБесе УЛгага 
(создание простых СОМ-объектов), бепейс С++ С!а5$ УЛгага (создание класса С++) 
и Ааа Мегтрег УамаЫе УЛгага (добавление переменной-члена). 

Всем этим мастерам доступны все объектные модели У!5иа! ЗАю — именно 
через эту призму среда воспринимает классы и другой код вашего приложения. 

Хорошенько «покопайтесь» в каталоге \Ргоргат ЕЦез\М1сгозой \151а! Зшаю 
„МЕТ\УС7\УСУЛ2ага5 — там вы найдете все мастера У\15а!1 Знаю МЕТ. 


ГЛАВА 


Сопоставление 
сообщений \Л\Ип9о0\м$ 


В главе 3 вы узнали, как каркас приложений МЕС-библиотеки вызывает вирту- 
альную функцию Опр)гаи класса «вид». Заглянув в интерактивную справочную си- 
стему по библиотеке МЕС, вы узнаете, что класс Сей и его базовый класс Спа 
содержат несколько сотен функций-членов. Функции, имена которых начинают- 
ся с Оп — скажем, ОпКеуроит и ОшВийоп0р, — вызывает каркас приложения в 
ответ на события \У/Лп4о\5$ вроде нажатий клавиш и щелчков мышью. 

По большей части это не виртуальные функции, и поэтому они требуют до- 
полнительных усилий при программировании. В данной главе мы покажем, как в 
окне Ргорегие$ утилиты С1а55 У1еуу создать структуру карты сообщений (теззазе 
тар) для подключения кода ваших функций к каркасу приложения. 

В первых двух примерах этой главы используется обычный класс Се. В при- 
мере ЕхО5а мы обсудим взаимодействие инициируемых конечным пользователем 
событий и функций Опргаш. Пример ЕхО5Ь познакомит вас с резульгатом при- 
менения различных режимов иреобразования координат (тарр тодез) в УЛп4о\5. 

В большинстве практических задач вам понадобятся окна с прокруткой (зсгоШпе 
уеу). Поэтому в примере ЕхО5с вместо Се используется класс СустоШеи», по- 
зволяющий каркасу приложения библиотеки МЕС разместить в окне линейки 
прокрутки и связать их с изображением. 


Прием вводимых пользователем данных: 
функции карты сообщений 


Приложение ЕхОЗа из главы 3 не реагирует на действия конечного пользователя 
(за исключением стандартных команд УЛпо\з для изменения размеров и закрытия 
окна). Окно содержит меню и панель инструментов, но’они не «подключены» к 
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коду класса «вид». Меню и панели инструментов мы изучим лишь в третьей час- 
ти, так как они связаны с классом «рамка», но в \ш4о\$ много других источни- 
ков входной информации, которые не дадут вам расслабиться. Однако прежде чем 
вы сможете обработать какое-либо событие \/паоуз, хотя бы и щелчок, вам нужно 
научиться пользоваться системой карт сообщений МЕС. 


Карта сообщений 


Когда пользователь нажимает левую кнопку мыши в окне представления, Хто 
посылает этому окну сообщение, а именно ИМ [ВОТТОМРО\МУ. Если в ответ на 
это сообщение программа должна выполнить какое-то действие, то в классе «вид» 
надо предусмотреть функцию: 


\0149 СМу\1ем: : ОпЕВиЕтопбомп ( ИТМТ пЕ1адз, СРо1пЕ розпЕ) 
{ 

// код обработки сообщения 
} 


а в заголовочном файле класса — указать соответствующий прототип: 
аРх_тз9 №019 ОпЕВи{фопбомп(ИТМТ пЕ1адз, СРо1пе ро1п{); 


Элемент ах _т58 преобразуется препроцессором в пустую строку и напоми- 
нает о том, что перед нами функция карты сообщений. Далее в коде программы 
должен присутствовать макрос карты сообщений, подключающий функцию Опй[.Ви- 
юпроилт к каркасу приложения: 


ВЕСТМ_МЕЗЗАСЕ_МАР(СМУ\/1ем, С\лем) 
О№_ММ_ЕВУТТОМО0Мм() // Запись для ОпЕВи{топбомп 
// Другие записи карты сообщений 
ЕМО_МЕЗЗАСЕ_МАР() 


И, наконец, заголовочный файл класса должен содержать оператор: 
ОЕСЕАВЕ_МЕЗЗАСЕ_МАР() 


Как же узнать, какая именно функция соответствует определенному сообще- 
нию \ 90%? В приложении А (а также в интерактивной справочной системе 
библиотеки МЕС) вы найдете таблицу, где перечислены все стандартные сообще- 
ния УЛпаоу%$ и прототипы соответствующих им функций-членов. Вы можете про-. 
граммировать функции обработки сообщений вручную — для некоторых сооб- 
щений это даже необходимо. К счастью, в У151а1 С++ МЕТ окно Ргорегие$ инстру- 
мента С1а5$ У1еу/ автоматизирует кодирование большинства функций карты со- 
общений. 


Сохранение состояния объекта «вид»: 
переменные-члены класса 


Если программа принимает вводимые пользователем данные; имеет смысл реа- 
лизовать некоторую «визуальную» обратную связь. Функция Оп)гаи) класса «вид» 
рисует изображение на основании текущего состояния объекта «вид», и это со- 
стояние может изменяться в результате действий пользователя. В реальном МЕС- 
приложении состояние приложения обычно хранится в объекте-документе, но нам 
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еще далеко до этого. Пока же мы используем две переменные-члены класса «вид»: 
т_ тес ЕШрзе и т_пСоюг. Первая — это объект класса СКесЕ, который содержит 
текущий ограничивающий прямоугольник для эллипса, вторая — целое число, 
которое задает текущий цвет эллипса. 


Примечание По соглашению имена нестатических переменных-членов клас- 
са в библиотеке МЕС начинаются с т_. 


Наша функция карты сообщений будет переключать цвет эллипса (состояние 
объекта «вид») между серым и белым по щелчку левой кнопки мыши. Начальные 
значения 72 тесЕШрзе и т_пСот задаются конструктором класса, а функция-член 
ОтВийопроит переключает цвет. 


Примечание Почему для хранения состояния объекта «вид» не использовать 
глобальную переменную? Это может вызвать проблемы, если в прило- 
жении несколько таких объектов. Кроме того, инкапсуляция данных 
внутри объекта — одна’из основ объектно-ориентированного програм- 
мирования. 


Инициализация переменных-членов класса «вид» 
Лучшее место для инициализации переменной-члена класса — конструктор: 


СМУ\лем: : СМУ\1ем() : т_гес{Е111р$зе(0, 0, 200, 200) {...} 


Аналогично можно инициализировать 7_иСо/ог. Так как это переменная встро- 
енного типа (целое), компилятор сгенерирует такой же код, как если задейство- 
вать в теле конструктора оператор присваивания. 


Теория недействительного прямоугольника 


Функция ОВийопроити может сколько угодно переключать значение 7т2_иСо!, 
но если это все, что она делает, функция Оп)гейл не будет вызвана (при условии, 
конечно, что пользователь, к примеру, не изменит размеры окна). Функция Ой[Вш- 
юпроши должна вызывать функцию тоайашеКес! (функция-член, наследуемая 
классом «вид» от Спа). поайажшеКес! инициирует отправку \Лпао\$-сообщения 
УМ РАМТ, которое в классе СШеи сопоставлено вызову виртуальной функции 
Оп)гаи» которой при необходимости доступен параметр «недействительный пря- 
моугольник», который был передан в трайашеКес. 

В \шао\’$ существует два способа оптимизации операций рисования. Во-пер- 
вых, \/пао\5 обновляет только пикселы, расположенные внутри недействитель- 
ного прямоугольника. Таким образом, чем меньше размеры этого прямоугольни- 
ка (определяемые, скажем, обработчиком ОтЁВийопрои”т), тем быстрее он пере- 
рисовывается. Во-вторых, исполнение команд на рисование за пределами недей- 
ствительного прямоугольника — напрасная трата времени. Чтобы получить недей- 
ствительный прямоугольник, функция Оиртаи может вызвать функцию-член Се!- 
СИРВох класса СОС и таким образом избежать рисования объектов за пределами 
этого прямоугольника. Вспомните: Опрташ вызывается не только в ответ на вы- 
зов поайажеКесь но и когда пользователь изменяет размеры окна или открывает 
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невидимые ранее его части. Итак, функция Опргаш отвечает за все рисование в 
окне и обязана обрабатывать любые передаваемые ей недействительные прямоу- 
ГОЛЬНИКИ. 


но код, реали Тиз 
правило прибегают к глобальным перем 


Клиентская область окна 


Клиентская область (сНепи агеа) — прямоугольная часть окна, в которую не вхо- 
дят рамка, заголовок, меню и стыкуемые панели инструментов. Ее размеры зада- 
ет функция-член бесйетКес! класса СУпа. Обычно рисовать за пределами этой 
области не разрешается, да и большинство сообщений мыши поступает в окно, 
только когда ее указатель находится в пределах этого окна. 


Арифметические операции с СВесЕ, СРотЁ и С$/2е 


Классы СКеср, СРойи и Се — производные от структур \Итао\з КЕСТ, РОМТ и 
ЗЕ и поэтому наследуют такие целочисленные переменные-члены: 


СКест ей, ор, "терь Бопот 
СРойй ху 
(512е сусу 


В справочнике Мтозой Еоип4аноп Са Ке{етепсе для этих классов определе- 
но множество перегруженных операторов. Вы можете, в частности: 
Ш прибавлять объект С5#2е к объекту СРотЕ 
вычитать объект С5е из объекта СРотЁ 
вычитать один объект СРойи из другого, в резульгате получая объект С5#е; 
прибавлять к объекту СКес! объект СРой! или С512е; 
вычитать из объекта СКес! объект СРойЁ или Се. 


Класс СКес! содержит связанные с классами СРоййи Се функции-члены. 
Например, функция-член 70рГей возвращает объект СРО, функция 51е — объект 
С5е. Таким образом, становится понятно, что объект Се — это «разница» меж- 
ду двумя объектами СРО а объект СЮесЁ можно «сместить» на СРотЕ 


Попадает ли точка внутрь прямоугольника? 


В классе СКес! есть функция РИиКесь, проверяющая, попадает ли точка в прямоу- 
гольник. Второй параметр ОтВинопрошт — рот! — это объект класса СРойи, 
задающий место указателя мыши в клиентской области окна. Чтобы узнать, нахо- 
дится ли точка внутри прямоугольника 7 тесЕШрзе, нужно сделать так: 
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1 (т_гес{Е111рзе. РЕТпВест (ро1п{)) { 
//Точка расположена внутри прямоугольника 


Однако, как вы скоро поймете, этой простой проверки хватает, только если вы 
работаете в координатах устройства (что пока верно). 


Оператор СНес! [РСАЕСТ 


В справочнике Мгозой Еоипаайоп С1а55 ПОтату Кеетепсе отмечено, что Спа: п- 
гайажшеКес! принимает параметр [РСКЕСТ (указатель на структуру КЕСТ), а не СКес. 
Но СКес! допускается как параметр, так как в классе СКес{ определен перегружен- 
ный оператор ГРСКЕСТО, возвращающий адрес объекта СКеср, что эквивалентно 
адресу объекта ЮЕСТ. Поэтому компилятор, если надо, автоматически преобразу- 
ет аргументы СКесЁ в ГРСКЕСТ, и функции можно вызывать так, как если б они имели 
в качестве параметров ссылки на СКес. 

Следующий фрагмент кода функции-члена класса «вид» получает координаты 
клиентского прямоугольника и сохраняет их в те СИепё 


СВесф гестС11епт; 
бетС11ептНес* ( гес+С11еп{); 


Попадает ли точка внутрь эллипса? 


Код примера ЕхО5а определяет, нажата ли кнопка мыши внутри прямоугольника. 
Корректнее было бы проверить, попал ли указатель мыши в эллипс. Для этого нужно 
создать объект класса СКоп, соответствующий эллипсу, и затем вместо РИпКес 
вызвать функцию РИпКестюп. Вот этот фрагмент программы: 


СВап гоп; 
гоп. СгеатеЕ111р{1сВдпТп91 гес* (т_гес{Е111рзе); 
11 (гдп.РЕТиВед1оп(ро1п*)) { 

//Точка расположена внутри эллипса 


} 


СтеиеЕшрисКоптагес! — еще одна функция, принимающая параметр /РСКЕСТ. 
Она создает специальную внутреннюю структуру области (тезлоп) УЛт4Чо\$ — 
эллиптическую область внутри окна. Затем эта структура связывается с объектом 
С++ СКоп в программе. (Структуру этого же типа применяют и для представления 
многоугольника.) 


Пример Ех05а 


В примере ЕхО5а эллипс (здесь он оказывается кругом) изменяет цвет по щелчку 
левой кнопки мыши, а указатель мыши находится в прямоугольнике, описанном 
вокруг эллипса. Для хранения состояния служат переменные-члены класса «вид», 
а для перерисовки изображения — функция моайашщеКес. 

В примере ЕхОЗа в главе 3 рисование в окне зависело только от одной функ- 
ции Опрташ. В примере ЕхО5а нам понадобятся три функции (в том числе конст- 
руктор) и две переменные-члены. Полный текст файлов заголовка и реализации 
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для класса СЕхО5аМеи показан ниже. Все изменения по сравнению с кодом, сге- 
нерированным МЕС Арр|сайоп \У/лгага, а также ОйГВийопроит, выделены. 
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см. след. стр. 
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мо СБхОБаМ! 


Использование С!а$$ \Меми с Ех05а 
Взгляните на фрагмент Ех05а\ех\у. В: 

ах. т$9 \019 ОпЕВифопбомп(ИТМТ пР]ад$, СРо1пе ро1п{); 
и на фрагмент ЕхО5а\У1е\у.срр: 


ОМ иМ_ЕВиТтомоОмм( ) 


В предыдущей версии \15ча1 С++ мастер АррУ/2агА размещал здесь специаль- 
ные комментарии для С1а55УЛага. К счастью, потребность в подобных коммен- 
тариях отпала: \У15ща1 С++ МЕТ постоянно отслеживает состояние всего кода, в том 
числе сопоставленния функций и отдельных строк исходного текста. Мастера ис- 
ходного кода, доступные в окне РгорегИе$ средства С!а$$ У\ле\, добавляют прото- 
типы обработчиков на основании внутренней информации. Кроме того, они ге- 
нерируют шаблон функции-члена Ой[Винопроит в ЕхО5а\1еуу.срр, который содер- 
жит соответствующие объявления типов параметров и возвращаемого значения. 

Обратите внимание на отличие связки между МЕС АррИсаноп \/Л2ага и масте- 
рами исходного текста от обычного генератора исходных текстов. Обычный ге- 
нератор запускается один раз, после чего программист редактирует полученный 
код. МЕС АррИсаНоп У\/12агА запускается для генерации приложения только раз, 
но мастера С1!а$$ Уле\у можно использовать сколько угодно, и отредактировать код 
можно в любой момент. . 


Совместное использование МЕС АррИсаНоп \Мтаг4 и мастеров исходного текста 

Ниже описана последовательность создания приложения ЕхО5а с помощью МЕС 

АррНИсайоп УЛгагА и мастеров, доступных в окне РгорегИе$ средства С1а$$ У1е\у. 

1. Создайте Ех05а, используя МЕС Арр|саНоп \/12аг4. Сгенерируйте с помо- 
щью МЕС АррИсайоп УЛгага $0[-проект с именем ЕхО5а в подкаталоге \усрр32\ 
ех05а. Параметры и имена классов по умолчанию показаны ниже. 
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МЕС АррисаНоя \Агак ех05а 


бепега{ед С1а55е5 
Вемем депега(е4 ‹1а5ез ап@ зресйу Базе ‹аззез Гог уоиг аррйсавоп, 


2. Добавьте к СЕх05аЙеи переменные-члены т_гесЕШрзе и т_пСойог. 
В меню У1е\ выберите С!а5$ \1е\у, щелкните правой кнопкой класс СЕхО5ае, 
в контекстном меню выберите Ааа УанаЫе и вставьте две переменные-члены: 


рг1\уате: 
САест т_гестЕ111рзе; 
ТП т_пСо10г; 


Впрочем, этот код в объявление класса в ЕхО5а\М1еу,.В можно ввести вручную. 
3. В окне Ргорейце$ средства С!а55 Уле\уу добавьте обработчик сообщения 
в класс СЕх05а еш. В С!а55 \е\ выберите класс СЕхО5 аеш, как показано 
на рисунке, щелкните его правой кнопкой и в контекстном меню выберите 
Ргорегиез. Щелкните кнопку Меззазе$ на инструментальной панели Ргорегие. 
Выберите в списке запись УМ _[ВОТТОМРО\У. Рядом ней появится стрелочка 
поля со списком — выберите в нем <АЯа> ОпГВииопроуп. В исходный код 
добавится функция ОйГВийопроши, текст которой появится в окне редактора 
исходного кода Соде ЕаЦог. 


ВЕ}. +Ф соБа! РипсНопз апд уамаЫез 
8-Е Масгоз ап9 СопэапЕ$ 
+ 3 САБочЕО9 
$ Сех05айрр 


$ Сехозабос 


& У и. ы 
ее 4 СМатРгате 


4. Отредактируйте код функции ОшВийоп,оит в файле Ех05аУ1еу.срр. 
В открывшемся окне Со4е ЕЧКог замените код функции на выделенный (вве- 
дите его вручную): 


ГЛАВА 5 Сопоставление сообщений \М/Иптдо\м$ 61 


\014 СЕхО5а\1ем: : ОпЕВи{фопбомп( ИТМТ пР1ад$, СРозпе ро1от) 
{ 
1Е (т_гестЕ111рзе. РЕТпВес(ро1п{)) { 
11 (т_пСо1ог == @ВАУ_ВВУЗН) { 
м_пСо1ог = МНТТЕ_ВВУЗН; 
} 
е1зе { 
м_пСо1ог = @6ВАУ_ВВОЗН; 
} 
Тпуа11датевест (т_гестЕ111рзе); 


} 


5. Отредактируйте конструктор и функцию ОпОгаи в файле Ех05а- 
Ул1е\у.срр. Вместо сгенерированного кода надо вручную ввести выделенный код: 


СЕхО5а\1ем: : СЕх05а\1ем() : м_гестЕ111рзе(0, 0, 200, 200) 
{ 

п_пСо1ог = СВАУ_ВВУЗН; 
} 


\0149 СЕхО5а\1ем: :Оп0гам(С0С» роб) 
{ 


роС->5е1есЕ$фоскО6]ест(т_пСо1ог); 
р0С->Е111рзе(т_гес+Е111рзе); 
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6. Соберите и запустите программу. В меню ВиЙ4 выберите команду Вийа ЕхО5а 
или щелкните на панели инструментов ВиПА кнопку: 


Выберите в меню РеБиз команду 51а Х/иоцЕ БеБизо1пе. Полученная про- 
грамма в ответ на щелчок изменяет цвет круга в окне представления. (Не на- 
жимайте кнопку два раза подряд слишком быстро — УЛп4о\$ интерпретиру- 
ет это как один двойной. щелчок, а не как два одиночных.) 


Режимы преобразования координат 


До этого момента мы задавали координаты для рисования в пикселах экрана или 
в так называемых координатах устройства (Аеу1се сооглатез). Ех05а использу- 
ет в качестве координат пикселы, так как в контексте устройства установлен ре- 
жим преобразования координат (тарртз то4е) по умолчанию — ММ_ТЕХТ. Сле- 
дующий оператор рисует квадрат 200х%200 пикселов, левый верхний угол кото- 
рого совпадает с левым верхним углом клиентской области окна (ось ординат у 
направлена вниз): 


роС->Вестапа1е (СВест(0, 0, 200, 200)); 


На дисплее с разрешением 1024х768 пикселов такой квадрат будет выглядеть 
меньше, чем на стандартном мониторе УСА с разрешением 640х480, а при рас- 
печатке на лазерном принтере с разрешением 600 ар! он покажется вовсе кро- 
шечным. [Убедитесь в этом сами, выбрав команду программы ЕхО5а — функцию 
Рипе Ргеме\м (предварительный просмотр перед печатью]. 

А если размер квадрата должен быть 4Х4 см независимо от устройства отобра- 
жения? \УЛпЧо\$ предоставляет ряд других режимов преобразования координат 
(или систем координат), которые выбирают для контекста устройства. Коорди- 
наты в текущем режиме преобразования называются логическими координата- 
ми (1юзйса! сооглаиез). Если, например, выбрать режим преобразования ММ _Н/- 
МЕТЕЮГС, логической единицей станет не пиксел, а 0,01 мм. В режиме ММ ШМЕТЮС 
ось у направлена в противоположную сторону по сравнению с режимом ММ _ТЕХТ: 
при перемещении вниз значения у уменьшаются. Так что в логических коорди- 
натах квадрат 4х4 см можно нарисовать так: 


рОС->Весфапа1е(СВест(0, 0, 4000, -4000)); 


Выглядит просто, да? На самом деле это не так, потому что работать только в 
логических координатах нельзя. Программа постоянно переключается между 
координатами устройства и логическими координатами, и вы должны знать, ког- 
да выполнить соответствующее преобразование. Далее мы рассмотрим несколь- 
ко правил, которые облегчат вашу нелегкую долю программиста. Прежде всего 
познакомимся с тем, какие же режимы преобразования координат есть в ХЛп4о\. 


Режим преобразования ММ_ТЕХТ 


На первый взгляд, ММ_ТЕХТ — это вовсе и не режим преобразования координат, 
а лишь другое название для аппаратной системы координат. Верно, но не совсем. 
В режиме ММ_ТЕХТ координаты соответствуют пикселам, значения по оси х воз- 
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растают при движении вправо, значения по оси у возрастают при движении вниз, 
но можно переместить начало координат, используя функции 5ейЙешропОте и 
5елутаошОто класса СОС. Ниже приведен пример программы, устанавливающей 
начало логических координат в точку (100, 100) и рисующей затем квадрат с раз- 
мерами 200х200 пикселов со смещением (100, 100) (рис. 5-1). Логическая точка 
(100, 100) соответствует точке (0, 0) в аппаратных координатах. Подобное пре- 
образование применяется в окне с прокруткой. 


\019 СМу\1ем: :Оп0гам(С0С* р0С) 

{ 
р0С->5е{МарМоаде (ММ_ТЕХТ); 
р0С->5е+и1пдомОго (СРо1п*(100, 100)); 
р0С->Вестапа1е(САест(100, 100, 300, 300)); 


Рис. 5-1. Рисование квадрата после того, как начало координат 
перемещено в точку (100, 100) 


Режимы преобразования координат с постоянным масштабом 


Важная группа режимов преобразования координат \Лп4о\/; — режимы с посто- 
янным масштабом. Как вы уже видели, в режиме ММ _НИМЕТК/ГС значения х возра- 
стают при перемещении вправо, а значения у убывают при перемещении вниз. 
Это соглашение соблюдается во всех режимах с постоянным масштабом, и изме- 
нить его нельзя. Единственное различие между режимами с постоянным масшта- 
бом — фактический масштабный множитель, который определяется, как показа- 
но в табл. 5-1. 


Табл. 5-1. Масштабный множитель различных режимов преобразования 
координат 


Режим преобразования координат Логическая единица 
ММ_ГОЕМСИ$Н 0,01 дюйма 
ММ_ШЕМСИ$Н 0,001 дюйма 

ММ ГОМЕТЕС 0,1 мм 
ММ_НМЕТЮС 0,01 мм 


ММ_ТРУ 1/1440 дюйма 
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Последний режим преобразования — ММ. Т1Р5 — чаще всего используется при 
работе с принтерами. Один {р равен 1/20 пункта. [Пункт (рой) (сокращенно 
пт), — единица измерения размера шрифтов. В \Лп90\у$ 1 пт = 1/72 дюйма.] Если 
в режиме ММ_Т71Р5 нужен шрифт размером 12 пт; установите высоту символа в 
12х20, т.е. 240 \1рз. 


Режимы преобразования координат с переменным масштабом 


УЛпао\5 предоставляет два режима преобразования координат, позволяющих 
изменять не только начало координат, но и масштабный множитель: ММ_бОТКОМС 
и ММ_АМОТКОРГС. В этих режимах можно изменять размеры рисунка, когда 
пользователь изменяет размеры окна, а также переворачивать изображение, из- 
меняя знак масштабного множителя или задавать произвольные масштабные 
множители. 

В режиме ММ_БОТКОРС всегда поддерживается коэффициент пропорциональ- 
ности между осями, равный 1:1. Иначе говоря, при изменении масштабного мно- 
жителя круг все равно остается кругом. В режиме ММ АМЗОТКОР/С масштабные 
множители по осям хи у изменяются независимо друг от друга. Круги могут вы- 
рождаться в эллипсы. 

Эта функция Оиртгаи рисует эллипс, точно вписывающийся в размеры окна: 


\019 СМу\1ем: :ОпО0гам(С0С* роб) 
{ 
СВесЕ гесеС11епт; 
бетС11еп{Вест ( гестС11еп{); 
р0С->5е1{МарМоде (ММ_АМТЗОТНОРТС); 
р0С->5е{И1паомЕхе( 1000, 1000); 
р0С->е\У1емрогтЕхт ( гесЕС11епт. г1дй{, -гесеС11епт. Бофот); 
роС->5е\/1ерог{0га( гесЕС11епт. г1дп{ / 2, гесфС11епе. боком / 2); 


р0С->Е111рзе(СВесе(-500, -500, 500, 500)); 


Как она работает? Функции 5еЛЙтаошЕх+ и зейЙешройЕ»1 совместными усилиями 
задают масштабные множители в зависимости от текущего размера клиентской 
области окна, который возвращает функция СеСйетЖес. В резульгате размер окна 
равен точно 1000х1000 логических единиц. Функция 5ейлешропОте устанавлива- 
ет начало координат в центр окна. Так что эллипс с радиусом 500 логических 
единиц и с центром в центре окна целиком заполняет окно (рис. 5-2). 

Вот формулы преобразования логических координат в координаты устройства: 


Ш <масштаб по х> = <размер области вывода по х> / <размер окна по х>; 

Ш <масштаб по у> = <размер области вывода’по > / <размер окна по у>; 

Ш <аппаратная координата по х> = <логическая координата по х> * «масштаб по 
х> + <смещение начала координат по х>; 

Ш <аппаратная координата по > = <логическая координата по у> * «масштаб по 
> + <смещение начала координат по у>. 


Допустим, ширина окна 448 пикселов (гесСйеттеЬ). Правый край клиентс- 
кой области эллипса находится в 500 логических единицах от начала координат. 
Масштаб по оси х равен 448/1000, а смещение начала координат по х — 448/2 ап- 
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паратных единиц. По приведенным формулам координата правого края клиент- 
ской области эллипса окажется равной 448 аппаратным единицам, т. е. координате 
правого края окна. Масштаб по х выражен как отношение «размер области выво- 
да/размер окна», так как координаты в УЛп4о\$ — это целые числа, а не величи- 
ны с плавающей запятой. Сами по себе размеры области вывода или окна смысла 
не имеют. 

Если в предыдущем примере заменить ММ _АМ!ОТКОРГ на ММ_5ОТКОРГ, то 


«эллипс» всегда будет кругом (рис. 5-3), а его радиус — равным длине меньшего 
измерения окна. 


Рис. 5-2. Центрированный эллипс в режиме преобразования координат 
ММ_АМЗОТВОР!С 


Рис. 5-3. Центрированный эллипс, нарисованный в режиме преобразования 
координат ММ _ТЗОТКОР!С 


66 Часть ПИ Основы МЕС 


Преобразование координат 


После определения режима преобразования координат (и начала координат) 
большинству функций-членов СОС можно в качестве параметров передавать ло- 
гические координаты. Однако если вы получаете координаты курсора мыши из 
сообщения УЛпао\з (параметр ройй в ОтВийопроит), это аппаратные коорди- 
наты. Корректная работа многих других функций МЕС, в частности функций-членов 
класса СКеср, возможна только в аппаратных координатах. 


Примечание \/132-функции арифметики СКес! используют соответствующие 
арифметические функции \/1132 для КЕСТ, в которых подразумевается, 
что 74Е больше (ей, а Бойот больше юр. Скажем, для прямоугольника 
(0, 0, 1000, -1000) в координатах ММ _ШМЕТКГС значение БоНот меньше 
юр, и этот прямоугольник не удастся обработать функциями вроде СКеси::Р!- 
тКес, если предварительно не вызвать СКес!:.МоттайзеКесьЬ чтобы из- 
менить значения переменных-членов СКес! на (0, -1000, 1000, 0). 


Более того, скорее всего понадобится третий набор координат — физических. 
Зачем? Допустим, вы используете режим ММ _ГОЕМСИ$Н, где логическая единица 
равна 0,01 дюйма, но. 1 дюйм на экране представляет собой фут (12 дюймов) в 
реальном мире. Далее. Пусть пользователь работает с дюймами и десятичными 
дробями. Значение 26,75 дюймов преобразуется в 223 логические единицы, которые 
затем нужно преобразовать в координаты устройства. Во избежание ошибок ок- 
ругления физические координаты следует хранить либо как числа с плавающей 
запятой, либо как целые (10п2) с масштабным множителем. 

Преобразования физических координат в логические остаются на вашей со- 
вести, а вот о преобразовании логических координат в аппаратные позаботится 
СОТ УЛпдо\5. Преобразование между двумя системами выполняют функции /РюрР 
и РРЮГР класса СОС, при этом предполагается, что режим преобразования коор- 
динат и связанные с этим параметры контекста уже заданы. Ваша задача — решить, 
когда какую из систем координат использовать. Вот несколько правил. 


Ш Считайте, что все параметры, передаваемые в функции-члены СОС, — это ло- 
гические координаты. 

Ш Считайте, что все параметры, передаваемые в функции-члены Са, — это 
аппаратные координаты; 

Ш Проверяя, попадает ли указатель мыши в определенную область, используйте 
аппаратные координаты. Задавайте области в аппаратных координатах. Такие 
функции, как СКес!::РИпКесь, лучше всего работают, если применяются аппа- 
ратные координаты. 

Ш Значения, сохраняемые на длительное время, должны использовать логичес- 
кие или физические координаты. Если вы сохранили значение точки в аппа- 
ратных координатах и пользователь прокрутил изображение в окне, то сохра- 
ненное значение станет недействительным. 


Пусть нам надо узнать, находится ли указатель мыши в момент нажатия левой 
кнопки в прямоугольнике. Вот соответствующий код. 
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// т_гесф = это переменная-член типа’ СВесе производного класса “вид”, 
// содержащая логические координаты ММ_1ТОЕМСЕТ$Н 


\0149 СМу\тем: : ОпЕВиопбомп( ИТМТ пЕ1адз, СРолпф ро1п{) 
{ 
СВесф гест = т_гест; // гест - временная копия т_гест 
СС11еп{0С ас(111$); // Получение контекста устройства 
// для Зе{МарМоде и 1РобР 
// - подробности в следующей главе 
дс. е{МарМоде (ММ_1ОЕМСЕТЗН): 
дс. 1Рфо0Р ( гест); // Теперь гесф содержит координаты устройства 
1 (гесф. РЕТпВест(ро1п*)) { 
ТВАСЕ( "Моцзе сигзог 1$ 11314е {Пе гесфапо1е.\п “”) 
} 


Обратите внимание на использование макроса ТКАСЕ (описан в главе 2). 


Примечание Как вы скоро увидите, режим преобразования координат лучше 
устанавливать не в функции ОпОгаи», а в виртуальной функции ОпРге- 
ратерс класса СШеш. 


Пример Ех05Ь: переход в режим 
преобразования координат ММ _Н/МЕТА/С 


ЕхО5Ь представляет собой пример ЕхО5а, модифицированный для поддержки пре- 
образования координат в режиме ММ ШМЕТКГ. В проекте ЕхО5Ь на компакт-диске 
имена классов и файлов другие, однако ниже рассказано, как преобразовать код 
проекта ЕхО5а. Как и Ех05а, Ех05Ъ выполняет проверку на попадание указателя 
мыши в заданную область и изменяет цвет эллипса только при щелчке внутри опи- 
санного прямоугольника. 


1. Вокне Ргорегие$ инструмента С!а5$ У1еуу переопределите виртуальную 
функцию ОпРгерагерс. (125$ У1еу’ позволяет переопределять виртуальные 
функции некоторых базовых классов МЕС, в том числе СИеш,, в окне Ргорегиез. 
Соответствующий мастер генерирует прототип функции в заголовочном файле 
класса и шаблон тела функции в СРР-файле. В окне С!аз5 У1е\/ щелкните пра- 
вой кнопкой имя класса СЕхО5а\еи и в контекстном меню выберите Ргорегиез. 
Щелкнув кнопку Оуегиае$ на панели инструментов окна Ргорегиез, выберите 
в списке функцию ОпРхератерс и отредактируйте ее следующим образом: 


\019 СЕсО5а\1ем: :ОпРгерагедС(С0С» рОб, СРгалпЕТпРо» рТио) 
{ 

роС->Зе{МарМоде (ММ_НТМЕТВАТС); 

С\У1е\м: :ОпРгерагедС (роб, рТпРо): 


Каркас приложения вызывает виртуальную функцию ОпРхератерС прямо 
перед вызовом ОпО)гаш.. 
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2. Отредактируйте конструктор класса «вид». Надо изменить значения коор- 
динат прямоугольника эллипса. Теперь размер прямоугольника равен 4х4 см, 
ане 200х200 пикселов. Заметьте: значение у должно быть отрицательным, иначе 
эллипс будет выведен на «виртуальный экран», расположенный непосредственно 
над монитором! Измените значения, как показано ниже: 


СЕхО5а\1ем: : СЕх05а\1ем() : т_гес{тЕ111рзе(0, 0, 4000, -4000) 
{ 

т_пСо10ог = СВАУ_ВВУЗН; 
} 


5. Отредактируйте функцию ОшВиНоп,)оши. Теперь для проверки попада- 
ния в прямоугольник она должна преобразовать координаты эллинса в коор- 
динаты устройства. Измените функцию следующим образом: 


\0149 СЕхО5а\1ем: : ОпЕВиФопВомп(ИТМТ пЕ1адз, СРо1пЕ ро1п*) 
{ 
СС11еп0С 9с(111$); 
ОпРгерагебС( &4с); 
СВесф гес{0еу1се = т_гестЕ111рзе; 
9с. ЕРЕо0Р( гес{)еу1се); 
1! (гесЕ0ем1се. РЕТиВес*(ро1пт)) { 
17 (м_пСо1ог == @ВАУ_ВВУЗН) { 
т_пСо1ог = ИНТТЕ_ВВОЗН 
} 
е1зе { 
м_пбсо1ог = СВАУ_ВВУЗН 
} 


]пуа11датеНест ( гес{беу1 се); 


} 


4. Соберите и запустите программу Ех05Ъ. Программа работает так же, как и 
ЕхО5а, за исключением того, что размер эллипса другой. В режиме предвари- 
тельного просмотра печати вы увидите, что эллипс гораздо больше, чем в ЕхО5а. 


Окно представления с прокруткой 


Как следует из отсутствия линеек прокрутки (5сго! Багз) в примерах ЕхО5а и ЕхО5Ь, 
МЕС-класс СИеи? — базовый класс для СЕхО5ЬИеи — сам прокрутку не поддержи- 
вает. Ее поддерживает другой класс — СустоШЙеи». СустоШеи» — наследник Се. 
Мы создадим новую программу ЕхО5с, использовав С5стоЙеи вместо СИеш. Код 
преобразования координат, написанный для ЕхО5Ъ, подготовил все, что нужно для 
реализации прокрутки. 

Класс СбстоШЛеиш поддерживает прокрутку через линейки прокрутки, но нес 
клавиатуры. Добавить поддержку прокрутки с клавиатуры легко, и мы это сделаем. 


Окно — это больше, чем видно на экране 


Если мышью уменьшить размеры обычного окна, его содержимое останется не- 
подвижным относительно его левого верхнего уровня, а элементы, расположен- 
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ные снизу и справа, исчезнут из поля зрения. После увеличения окна они появят- 
ся вновь. Отсюда логично заключить, что окно больше, чем его область вывода 
(уле\урого, которую вы видите на экране. Однако область вывода не обязана быть 
жестко привязанной к левому верхнему краю окна. Благодаря функциям $стой- 
Уйпаош и бепУтаошОтв объекта С\па, класс С5стоЙеш позволяет перемещать 
область вывода в любое место окна, включая области, расположенные выше и левее. 


Линейки прокрутки 


Мисгозой УЛп4до\$ позволяет легко отобразить линейки прокрутки по краям окна, 
однако УЛпо\$ сама по себе не пытается подключить их к окну. Эту задачу вы- 
полняет класс СустоШЛеш. Функции-члены С5стоШЙеш обрабатывают сообщения 
УМ_Н5СКОМ, и УМ_УУСКОМ, которые линейки прокрутки посылают объекту «вид». 
Эти функции перемещают область вывода внутри окна и выполняют необходи- 
мые вспомогательные действия. 


Различные способы прокрутки 


Класс С5стоЛеиш поддерживает один определенный способ прокрутки, в котором 
используется одно большое окно и маленькая область вывода. Для каждого эле- 
мента определено положение в большом окне. Например, если нужно отобразить 
на экране 10 000 адресных строк, то вместо окна длиной в 10 000 строк, вероят- 
но, лучше иметь небольшое окно, поддерживающее алгоритм прокрутки, который 
выбирает для отображения столько строк, сколько можно отобразить в данный 
момент. В нашем случае надо создать свой производный от Се класс «вид» с 
прокруткой. 


Функция ОптаШраае 


Подробнее о ней вы узнаете при изучении архитектуры «документ-вид», которое 
мы начнем с главы 15. Здесь виртуальная функция ОтийаЮраее важна потому, 
что к ней первой обращается каркас приложения по завершении создания окна 
представления, но перед вызовом Опй)га», так что именно в Отийе!Праеше сле- 
дует задать логический размер и режим преобразования координат для вывода с 
прокруткой. Эти параметры устанавливает функция СбстоМЙеи»::5е стоЙ81ез. 


Прием данных, вводимых с клавиатуры 


Прием данных, вводимых с клавиатуры, — двухэтапный процесс. \Лю4о\у$ направ- 
ляет в окно сообщения М_КЕУРО\М и УМ_КЕУОР с кодами виртуальных кла- 
виш (уштаа! Кеу содез), но на пути к окну эти сообщения преобразуются. Если введен 
символ АМ$] (в результате чего генерируется сообщение УМ_КЕУРОММЮ), функция 
преобразования проверяет состояние регистра клавиатуры и направляет сообщение 
\УМ_СНАК с кодом соответствующего символа — либо верхнего, либо нижнего 
регистра. Клавиши перемещения курсора и функциональные клавиши не имеют 
соответствующих кодов символов, поэтому для них преобразования не требует- 
ся. Окно получает только сообщения УМ _КЕУРО\УМ и УМ _КЕУОР. 

Создать в своем классе «вид» обработчики этих сообщений вы можете в окне 
Ргорегие$ в С!а5$ У1еуу. Если предполагается принимать данные с алфавитно-циф- 
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ровых клавиш, обрабатывайте ИМ_СНАК; если нужно обрабатывать нажатия и 
других клавиш, обрабатывайте УМ_КЕУРО\М. Библиотека МЕС предоставляет в 
качестве параметра функции-обработчика код символа или виртуальной клавиши. 


Пример Ех05с: прокрутка 


Задача Ех05с — создать логическое окно с размерами 20 см в ширину и 30 см в 
высоту. Программа рисует тот же эллипс, что и в ЕхО5Ь. Можно отредактировать 
исходные файлы ЕхО5Ь и заменить базовый класс СИеи на С5стоТеи», но проще 
начать снова с МЕС АррИсацоп УЛ2ага, который и сгенерирует функцию, переопре- 
деляющую ОпйийжЮраее. 


1. С помощью МЕС АррНсаНоп У/1таг4 создайте Ех05с. Создайте $01-проект 
ЕхО5с в подкаталоге \усрр32\ех05с. Установите класс С5бстоЙИеи в качестве 
базового для класса СЕХхО5Иеи»: 


ЕМС Аррусаноп М гаг — ©5055 


бепега{е4 С1а55е$ 
Веме\м депегаке4 с1а55е5 ап4 зресу Базе ‹/аззез Гог уоиг аррйканоп. 


2. Добавьте в Ех05сУ1еу.В переменные-члены т_гесИЕШрзе и т_пСоог. Вставьте 
следующий код средствами Аа Метьег УайаЫе У/Лгага в окне Ргорегиез или 
введите текст вручную в объявлении класса СЕхО5сШеи»: 


рг1уате: 
СВесе т_гес+Е111рзе; 
11 т_пСо1ог; 


Это те же переменные-члены, что мы добавляли в проектах ЕхО5а и ЕхО5Ъ. 


3. Измените сгенерированную МЕС АррИ!сайоп У1хаг4 функцию Оштййи- 
Ораче. Отредактируйте ОпийеаПраше в файле ЕхО5с\1еуусрр: 


\019 СЕхО5с\У1ем: :ОпТп1{1а1Ирдате() 
{ 
С5$сго11\М1 ем: :ОпТп1{1а10рдате(); 
С$12е 317еТофа1(20000, 30000); // 20 на 30 см 
(С512е $17еРаде($12еТота1.сх / 2, 312еТота1.су / 2); 
(С5$12е 317е11пе($12еТо+а1.сх / 50, 312еТофа1.су / 50); 
$е15сго11$12е$(ММ_НТМЕТВАТС, 312еТофа1, $17еРаде, $12е11пе); 
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4. В окне Ргорег{е$ в С1!а5$ Улеу добавьте обработчик сообщения М. КЕУ:- 
РОУМ. Мастер создаст функцию-член ОпКеуроши, а также соответствующий 
прототип и запись в карте сообщений. Отредактируйте код так: 


\у019 СЕхО5с\1ем: :ОпКеубомп( ИТМТ пСпаг, ПТМТ пАерСпе, ИТМТ пЕ1ад$) 
{ 
зм1фсй (пСпаг) { 
сазе \УК_НОМЕ: 
0п\$сго11($В_ТОР, 0, МИН); 
ОпН$сго11 (ЗВ_ЁЕРТ, 0, №); 
Бгеак; 
сазе \УК_ЕМО: 
0п\/$сго11(5В_ВОТТОМ, 0, №); 
ОпН$сго11 (5В_ВТ@нт, 0, №); 
Ьгеак; 
сазе \УК_УР: 
0п\/$сго11 ($В_ЕТМЕУР, 0, МИ); 
Ьгеак; 
сазе \УК_о0мм: 
0п\$сго11 ($В_ЕТМЕВОММ, 0, МЕ); 
Ьгеак; 
сазе \УК_РВТОВ: 
0п\/$сго11 ($В_РАбЕУР, 0, №1); 
Бгеак; 
сазе УК_МЕХТ: 
0п\$сго11 (ЗВ_РАСЕСОММ, 0, Ми); 
Ьгеак; 
сазе УК_ЁЕРТ: 
ОпН$сго11 ($В_ЕТМЕЕЕРТ, 0, №1); 
Ьгеак; 
сазе УК_АТ@НТ: 
ОпН$сго11 ($В_ЕТМЕВТЕНТ, 0, №); 
Ьгеак; 
дегаи1*: 
Бгеак; 
} 
} 


5. Отредактируйте конструктор и функцию ОпО)гаи.. Измените в файле ЕхО5с- 
Уе\уусрр сгенерированные МЕС АррИсайоп У/2агА конструктор и функцию 
Опртгаш: 


СЕхо5с\1ем: : СЕхО5с\1ем() : м_гес+Е111рзе(0, 0, 4000, -4000) 
{ 

п_пСо1ог = СВАУ_ВВУЗН; 
} 


\014а СЕхО5с\1ем: :ОпО9гам(С0С» р0С) 

{ 
роС->5е1есЕ$фоскОБ] ест (т_пСо1ог); 
роС->Е111рзе(т_гес+Е111рзе); 


Эти функции идентичны аналогичным функциям из ЕхО5а и ЕхО5Ь. 
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6. 


Создайте обработчик сообщения УМ ТВОТТОМРОТМ. Измените сгенери- 
рованный код: 


У019 СЕхО5С\1ем: : ОпЕВиопбомп( ИТМТ пР1адз, СРо1пе ро1п+) 
{ 
СС11еп0С 9с(111$); 
ОпРгерагебС( &4с); 
СВесф гес+Оеу1се = п_гестЕ111рзе; 
дс. ЕРЕобР( гес1О0е\1се); 
11 (гесф0еу1се. РЕТпВес*(ро1п{)) { 
117 (м_пСо10ог == бВАУ_ВВУ$Н) { 
м_пСо1ог = МНТТЕ_ВВУЗН; 
} 
е13е { 
т_пСо1ог = СВАУ_ВВОЗН; 
} 
Тпуа11да+еНест( гес{0е\у1се); 


Функция идентична обработчику ОйЁВийопроши из проекта ЕхО5Ь. Как и 
там, она вызывает ОпРгератерс, но здесь есть отличие. В классе СЕхО5сИеш нет 
переопределенной функции ОпРгератерС, поэтому здесь вызывается Сбстой- 
Меш::ОпРгерагерС. В соответствии с первым параметром 5е5стой5#2ез эта фун- 
кция устанавливает режим преобразования координат, а также начало коор- 
динат окна согласно текущей позиции прокрутки. Преобразование координат 
необходимо для коррекции смещения начала координат, даже если использу- 
ется режим ММ _ТЕХТ. 

Соберите и запустите программу Ех05с. Убедитесь, что щелчок мышью 
работает, даже когда в результате прокрутки круг выходит за пределы окна. 


Проверьте прокрутку с клавиатуры. Результат работы программы должен выгля- 
деть, как показано на рисунке. 


ГЛАВА 5 Сопоставление сообщений М/пдо\$ $3 


Другие сообщения \Ип4до\$ 


Библиотека МЕС напрямую поддерживает сотни функций обработки сообщений 
УЛпаоууз. Кроме того, вы вправе определять собственные сообщения. В следую- 
щих главах вы найдете примеры обработки сообщений, в том числе сообщений 
от меню, дочерних окон-элементов управления и т. п. Пока же стоит обратить 
особое внимание на пять сообщений УЛпаоуз: ИМ_СКЕАТЕ, УМ_СГОЗЕ, УМ _ОИЕ- 
КУЕМОЗЕ$ ОМ, УМ _РЕУТКОУ и УМ _МСРЕУТКОУ. 


Сообщение И/М СРЕАТЕ 


Это первое сообщение, которое \Ип4о\з посылает окну!. Это происходит, когда 
каркас приложения вызывает функцию Стеше окна, так что к этому моменту со- 
здание окна еще не завершено и окно невидимо. Следовательно, ваш обработчик 
ОпСтеше не может вызывать функции \Лп4оууз, которые требуют уже готового 
окна.’ Эти функции можно вызывать в переопределенной функции ОптишаЮрае, 
однако в 5В1-приложениях последняя за время существования окна представле- 
ния может вызываться неоднократно. 


Сообщение ИМ СЕО$Е 


УЛпао\$ посылает сообщение ИМ_СГОБЕ, когда пользователь закрывает окно через 
системное меню или когда закрывается родительское окно. Реализовав обработ- 
чик ОпС[озе в производном классе, вы можете управлять процессом закрытия окна. 
Так, если нужно спросить у пользователя, сохранить ли изменения в файле, де- 
лайте это в ОпС|озе. Только убедившись, что окно можно безопасно закрывать, 
вызывайте функцию ОийСозе базового класса, которая продолжит процесс закры- 
тия. Объект «вид» и соответствующее ему окно в данный момент по-прежнему 
активны. 


Примечание При использовании всех средств каркаса приложения вы, веро- 
ятно, не станете применять обработчик события М _СГОЗЕ. Вместо этого 
можно переопределить виртуальную функцию СРоситепЕ::5 ареМо@йеа 
как часть высокоструктурированной процедуры завершения программы, 
реализованной каркасом приложения. 


Сообщение И/ИМ_СИЕАУЕМОЗЕ$ $ ОМ 


Сообщение УМ_ОПЕКУЕМОЗЕ$$ ОМ направляется во все исполняющиеся приложе- 
ния, когда пользователь завершает работу с УЛп49оу\5. Сообщение обрабатывает- 
ся функцией ОпОиегуЕпа5е5юп карты сообщений. Если вы пишете обработчик 
для ИМ_СГОЗЕ, напишите обработчик и для УМ_ОПЕКУЕМОЗЕ$ ОМ. 


' Это неверно: первым сообщением будет либо УМ _МССКЕАТЕ, либо 
УМ_СЕТМИУМАХМШЕО. — Прим. перев. 


Тоже ошибочное утверждение. Окно как структура ХЛп4о\у$ полностью создано, 
а библиотека МЕС уже присвоила его описатель переменной т_р\па класса Спа, 
хотя возврата из функции Стеше еще не было. — Прим. перев. 
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Сообщение И/М РЕ$ЗТАОУ 


Это сообщение, посылаемое УЛпао\5 после сообщения УМ_СГО5Е, обрабатыва- 
ется функцией карты сообщений Опрезтоу. Получив его, следует считать, что окно 
представления уже невидимо, но все еще активно, как и его дочерние окна. Обра- 
ботчик этого сообщения выполняет очистку, которая требует существования окна 
УЛпао\з. Обязательно вызовите функцию Опрезтоу базового класса. Функция 
Опрезтоу в классе «вид» не может отменить процесс уничтожения окна. Для это- 
го служит ОпС$е. 


Сообщение \ММ_МСБЕЗТАОУ 


Это последнее сообщение, посылаемое УЛп9о\5 при уничтожении окна. Все до- 
черние окна уже уничтожены. В ОиМсреятоу можно выполнить финальную обра- 
ботку, которая не требует наличия активного окна. На забудьте вызвать функцию 
ОпМ№Везтоу базового класса. 


Примечание Не пытайтесь уничтожать в ОиМсрезтоу динамически созданный 
объект-окно. Это действие выполняет специальная виртуальная функция 
РозИУсБезтоу класса СУпа, вызываемая из базового класса ОпМсрез!оу. 
О том, когда удалять объект-окно, см. МЕС Тесбиуса! Мое 17. 


ГЛАВА 


Классические функции 
графического устройства, 
шрифты и растровые 
изображения 


Мы уже встречались с элементами интерфейса графического устройства (СОП. 
Всякий раз при выводе чего-нибудь на дисплей или на принтер программа ис- 
пользует функции СП]! или СЬ1+. С функциями «классического» СО! мы познако- 
мимся в этой главе, а с функциями СП!+ — в главе 35, когда начнем обсуждать .МЕТ. 

Эти функции позволяют рисовать точки, линии, прямоугольники, многоуголь- 
ники, эллипсы, растровые изображения и вводить текст. Круги и квадраты вы 
сможете рисовать почти сразу, однако вывод текста — задача более сложная. Из 
этой главы вы узнаете, как эффективно использовать СП] в среде М1сгозой У150а1 
С++ МЕТ, работать со шрифтами на дисплее и на принтере. 


Классы контекста устройства 


В главах 3 и 4 функции-члену класса «вид» Оп)гаи передавался указатель на объект 
«контекст устройства». Оп)Огаи выбирала кисть и затем рисовала эллипс. Контекст 
устройства (4емсе сотцехо в Мсгозой УЛп4о\5 — ключевой элемент СПУ, слу- 
жащий для представления физического устройства. С каждым объектом «контекст 
устройства» С++ связан контекст устройства УЛп4оу\’$, идентифицируемый 32- 
разрядным описателем типа НОС. 

Библиотека МЕС предоставляет несколько классов контекста устройства. Ба- 
зовый класс СОС содержит все необходимые для рисования функции-члены, в том 
числе несколько виртуальных. Все производные классы, кроме СМеаЕйерс, от- 


76 Часть И Основы МЕС 


личаются только конструкторами и деструкторами. Если вы (или каркас прило- 
жения) создали объект производного класса контекста устройства, то указатель 
на СОС можно затем передать функции, например Оп)». Для дисплея обычно 
применяют производные классы ССИетс и СУтаоиОС, для других устройств, 
таких как принтеры или буферы памяти, — объекты базового класса СОС. 

«Виртуальность» класса СОС — важная особенность каркаса приложения. 
В главе 17 вы увидите, насколько легко написать код, работающий как с диспле- 
ем, так и с принтером. Например, оператор в Оп)таи»: 


роС->ТехЕ0ит(0, 0, “Не11о"); 


посылает текст на дисплей, принтер или в окно предварительного просмотра 
печати — все определяется классом объекта, на который ссылается параметр рос 
функции СИеш::Опртаи. Каркас приложения связывает описатели контекста уст- 
ройства с объектами, представляющими контексты устройств дисплея и принте- 
ра. Чтобы связать описатель контекста с объектами, представляющими контексты 
других устройств, таких как буфер памяти (с ним вы познакомитесь в следующих 
главах), вы должны после создания объекта вызвать специальную функцию класса. 


Классы контекста дисплея ССИеп С и СИтаоиосС 


Как вы помните, в клиентскую область окна не входят рамка, заголовок и меню. 
Если вы создадите объект ССйетШС, то получите контекст устройства, представ- 
ляющий только эту область, — рисовать за ее пределами невозможно. Точка (0, 0) 
обычно связана с верхним левым углом клиентской области. Как вы увидите, объект 
С\еиш соответствует дочернему окну, содержащемуся в отдельном окне-рамке, 
зачастую вместе с панелью инструментов, панелью состояния и линейками про- 
крутки. Все эти окна не входят в клиентскую область окна представления. Если, 
например, в верхней части окна имеется пристыкованная панель инструментов, 
то (0, 0) соответствует точке непосредственно под левым краем панели. 

Когда вы создаете объект СУтаошОС, точка (0,0) соответствует левому верх- 
нему краю неклиентской области окна. Этот полнооконный контекст устройства 
позволяет рисовать по рамке окна, в области заголовка окна и т. п. Не забывайте, 
что у окна представления нет неклиентской области, поэтому СтаошОС более 
подходит для окон-рамок, а не для окон-представлений. 


Создание и уничтожение СОС-объектов 


Важно своевременно уничтожать созданные объекты СОС по окончании работы 
с ними. Мсгозой УЛпао\уз ограничивает число доступных контекстов устройства, 
и, если не освободить контекст устройства \Ип4о\уз; небольшой участок памяти 
будет потерян до завершения программы. Чаще всего объект «контекст устрой- 
ства» создается в обработчике сообщения, например в От[Винопроит. Проще всего 
гарантировать уничтожение объекта «контекст устройства» (и освобождение со- 
ответствующего контекста устройства УЛп4оу\’з), создавая объект в стеке: 


у01а СМу\1ем: : ОпЕВиттопВомп(ИТМТ пЕ1адз, СРо1п ро1п+) 


{ 
СВесф гес*; 
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СС11еп{0С 9с(111$); // создание контекста устройства (9с) в стеке 
ас. ве{С11рВох( гес*); // получение ограничивающего прямоугольника 
} // контекст устройства автоматически освобождается 


Заметьте: конструктор объекта ССИей)С принимает в качестве параметра указа- 
тель на окно. Деструктор ССйет0С вызывается при возврате управления из функ- 
ции. Вы можете получить указатель на контекст устройства и через функции 
супа::Сеюс; не забывайте вызывать КееазерсС для освобождения контекста уст- 
ройства: 


№019 СМу\1ем: : ОпЕВифопбомп(ИТМТ пЕ1ад$, СРо1пт ро1пт) 
{ 


СВесф гест; 

С0С* рОС = @е+0С(); // Указатель на внутренний объект С0С 
роС->бе1С11рВох( гест); // Получение ограничивающего прямоугольника 
Ве1еазебС (рос); // Не забывайте эту операцию! 


} 


и 


Внимание! — Нельзя удалять СОС-объект, указатель на который передается фун- 
кции Оиргаш», — удалением этого занимается сам каркас приложения. 


Состояние контекста устройства 


Контекст устройства необходим для рисования. Когда вы используете ©Ос- 
объект для рисования, скажем, эллипса, полученное на экране (или на принте- 
ре) изображение зависит от текущего «состояния» контекста устройства, кото- 
рое включает: 


Ш связанные с контекстом объекты для рисования: перья, кисти и шрифты; 

Ш режим преобразования координат, определяющий масштаб элементов при их 
рисовании (мы уже экспериментировали с режимами преобразования коор- 
динат в главе 5); 


№ различные детали, например, параметры выравнивания текста и режим запол- 
нения многоугольников. 


Мы уже видели, что, если перед рисованием эллипса выбрать, скажем, серую 
кисть, внутренняя область эллипса закрашивается серым. Вновь созданный кон- 
текст устройства имеет некоторые характеристики по умолчанию, в частности 
черное перо для границ фигур. Остальные характеристики состояния назначаются 
с помощью функций-членов класса СОС. СО!-объекты выбирают для контекста 
устройства вызовом перегруженных функций 5$еесЮбес!. В любой момент в кон- 
тексте устройства можно выбрать только одно перо, одну кисть и один шрифт. 


Класс СРат ОС 


Класс СРаЙИШС нужен, только если вы переопределяете функцию ОпРайц для своего 
окна представления. Реализация ОпРай! по умолчанию вызывает Опртаи с нуж- 
ным образом настроенным контекстом устройства, но иногда требуется написать 
особый код рисования для конкретного дисплея. Особенность СРай ШС в том, что 
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его конструктор и деструктор делают то, что требуется конкретному дисплею. Од- 
нако, получив указатель на СРай ШС, вы можете использовать его точно так же, 
как и любой другой контекст устройства. Вот пример функции ОпРай\, создаю- 
щей объект СРАайИШОС: 


уУота СМУ\Лем: :ОпРа1пт() 
{ 
СРа1пт0С ас(+1И13); 


ОпРгерагебС ( &ас); // эта строка объясняется позднее 

дс. ТехЕ0и{ (0, 0, “Рог тне 013р1ау, поЕ {Не ргупфег”) 

ОпОгам( &ас): // действия, общие для дисплея и принтера 
} 

Для тех, кто программируе 


Конструктор и деструктор СРай ирС автоматически вызывают ВестРайи и 
'ЕпаРайи соответственно. Если контекст устройства создан в стеке, ЕнаРайи 
вызывается автоматически. _ о 


Объекты СО 


Каждый тип объектов СОТ ХЛ 40\5 представлен отдельным классом МЕС. ССа{- 
ОБес! — абстрактный базовый класс для классов СО-объектов. Объект СТЛ пред- 
ставляется объектом класса С++, производного от СоЮОБес. Вот эти классы. 


Ш СВитар (растровое изображение) — массив битов, в котором каждому пик- 
селу дисплея соответствует один или несколько битов. Растровые изображе- 
ния служат для отображения картинок, а также для создания кистей. 

Ш СВгизЬ (кисть) — точечный шаблон, используемый для закраски областей. 

Ш СРош (шрифт) — полный набор символов определенной гарнитуры и разме- 
ра. Обычно шрифты хранятся на диске как ресурсы, причем некоторые шрифты 
нужны лишь для определенных устройств. 

Ш СРещенНе (палитра) — интерфейс преобразования цветов, позволяющий при- 
ложениям в полной мере задействовать цветовые возможности устройства 
вывода, не мешая другим приложениям. 

Ш СРеп (перо) — инструмент для рисования линий и границ фигур. Можно за- 
дать цвет и толщину пера, а также указать тип линии — сплошная, пунктирная 
или штриховая. 

Ш СКзи (область) — многоугольник, эллипс или их комбинация. Области позво- 
ляют закрашивать, обрезать выводимое изображение и проверять попадание 
курсора мыши в определенные участки. 


Создание и уничтожение СО|-объектов 


Мы еще не создавали объектов класса ССЧЮБес+ — вместо этого мы конструиро- 
вали объекты производных классов. Конструкторы для некоторых классов, напри- 
мер, СРеп или СВги5р, позволяют указать достаточно информации для создания 
объекта за одну операцию. Создание других объектов, например, СЕоий или СКоп, 


ГЛАВА 6 Классические СО!-функции, шрифты и растры 79 


требует второй операции. Объекты этих классов создаются конструктором по 
умолчанию, после чего вызывается соответствующая функция, скажем, СтежеЕот! 
или СтежщеРойувопКви. 

У класса ССЮБесЕ есть виртуальный деструктор. Деструкторы производных 
классов удаляют СП]-объекты, связанные с соответствующими объектами С++. Если 
вы создали объект класса, производного от Со@Оесь то обязаны удалить его до 
завершения программы. Удаляемый СПО[-объект надо сначала отделить от контекста 
устройства. Соответствующий пример мы рассмотрим в следующем разделе. 


ный со объект растрового 
л ьный объем памяти. 


Управление СО!-объектами 


Итак, СО1-объекты нужно удалять, предварительно отсоединив от контекста уст- 
ройства. Но как? Функции семейства СОС::5@есОБуес! выбирают СП1-объект в 
контекст устройства и возвращают указатель на объект, выбранный в контекст до 
этого (и теперь отсоединенный). Но возникает проблема: отсоединить старый 
объект нельзя, не выбрав в контекст нового. Простое решение — сохранить све- 
дения о первоначальном СП]-объекте при выборе своего объекта в контекст и вос- 


становить его по завершении работы. После этого можно удалить свой СОГ-объект. 
Вот пример: 


\019 СМУлем: : Оп0гам(С0С* рос) 

{ 
СРеп пемРеп(Р$_ПБАЗНООТ, 2, (СОЕОВВЕР) 0); // черное перо шириной 2 пиксела 
СРеп* рО1аРеп = р0С->5е1ест06}ес+ ( &пемРеп); 


р0С->МоуеТо(10, 10); 

р0С->Е1пеТо(110, 10); 

роС->3е1ес{06) ес (р01аРеп); // пемРеп отсоединяется 
} // пемРеп автоматически уничтожается при выходе 


При уничтожении контекста устройства все его СОГ-объекты отсоединяются. 
Таким образом, если известно, что контекст устройства будет уничтожен до того, 
как уничтожатся выбранные в него объекты, отсоединять эти объекты не нужно. 
Так, если вы объявили перо как переменную-член класса «вид» (и инициализиро- 
вали его при инициализации объекта «вид»), то отсоединять перо внутри Оп)гаш 
не надо: контекст устройства, жизнью которого управляет обработчик ОпРай в 
базовом классе, будет уничтожен раньше. 


Стандартные СО!-объекты 


УЛпдо\$ предоставляет ряд стандартных СО/-объектов (5юсКк СОТ оБ}ес(з). Так 
как эти объекты — часть \/1190%у$, заботиться об их удалении не нужно: \/ЛпЧоууз 
игнорирует запросы на удаление стандартных объектов. Функция СОС::5 ес юс®- 
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ОБес! библиотеки МЕС выбирает стандартный объект в контекст устройства и 
возвращает указатель на выбранный ранее и отсоединяемый от контекста объект. 
Стандартные объекты удобны, когда нужно отсоединить собственный нестандар- 
тный СО]-объект перед его удалением. Стандартный объект можно применять 
вместо «старого» объекта, который использовался в предыдущем примере!: 


\019 СМу\1ем: :ОпО9гам( СОС» р0С) 
{ 
СРеп пемРеп(РЗ_ВАЗНООТ, 2, (СОГОВВЕЕ) 0): // черное перо шириной 2 пиксела 


роС->5е1естОЬ ест ( &пемРеп); 

р0С->МоуеТо(10, 10); 

роС->ЁЕ1пеТо(110, 10): 

роС->5е1есЕ$тоскОБ ест (ВЕАСК_РЕМ); // пемРеп отсоединяется 
} // пемреп автоматически уничтожается при выходе 


Стандартные перья, кисти, шрифты и палитры перечислены в описании фун- 
кции СБС::5есёЧюсвОБес! в справочнике Мтозой Роип4айоп С1а5; Ке{егепсе. 


Время жизни контекста устройства 


В случае контекста устройства «дисплей» в начале каждой функции-обработчика 
сообщения вы получаете «свежий» контекст. Набор выбранных объектов (а также 
режим преобразования координат и другие параметры контекста) теряется по 
завершении работы функции. Таким образом, контекст устройства надо всякий 
раз настраивать заново. Виртуальная функция-член ОпРгерагерсС класса СШеш 
удобна для установки режима преобразования координат, но своими СП]-объек- 
тами вы должны управлять сами. 

В контекстах других устройств, таких как принтеры или буферы памяти, на- 
значенные параметры могут сохраняться дольше. С такими «долгожителями» воз- 
никают сложности из-за временной природы указателей на объекты С++ контек- 
ста устройства, возвращаемых функцией 5@есеси. (Временный «объект» удаляется 
каркасом приложения при обработке цикла простоя приложения, некоторое время 
спустя после возврата управления обработчиком. Подробнее см. раздел МЕС ТесЬп]- 
са! Мое 3 справочной документации.) Нельзя просто сохранить указатель в пе- 
ременной-члене класса — вместо этого его нужно преобразовать в описатель 
УЛпао\$ (единственный постоянный идентификатор СПО!-объекта) с помощью 
функции-члена СебаеНапае. Вот пример: 


// т_рРг1пЕРопт указывает на объект СРоп+, созданный в конструкторе СМу\ем 
// м_П019РопЕ - это переменная-член СМУу\М1ем типа НЕОМТ, инициализированная нулем 


\014 СМУ\ем: : Зи{асиТобоиг1ег(С0С* рос) 
{ 
м_рРг1пЕРоп{->СгеафеРопт(30, 10, 0, 0, 400, РАГЗЕ, ЕАЕЗЕ, 
0, АМЗТ СНАВЗЕТ, ОУТ_ОБЕРАЦЕТ_РВЕСТ$, 
СЕТР_ОЕРАУЕТ_РВЕСТ$, ОЕРАЦЕТ_ОУАЕТТУ, 


' Вообще-то отказ от восстановления предыдущего объекта считается признаком пло- 


хого стиля программирования. — Прим. перев. 
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РЕРАЦЕТ_РТТСН | ЕЕ_МОБЕАМ, 
“Соиглег №№”); // шрифт типа. Тгие Туре 
СРоп{* р019Ропф = р0С->5е1ест06 ест (т_рРг1пРопт); 


// т_В019Ропт - открытая переменная-член С@9106]есф, в которой хранится описатель 
т_1019Роп{ = (НРОМТ) р019Ропт->бетбаРеНапа1е(); 


— 


\019 СМу\1ем: : м1 ЕсиТо0г191па1Роп*(С0С* р0С) 
{ 
// ЕгомНапа1е - статическая функция-член, 
// возвращающая указатель на объект 
1е (м_п019Роп*) { 
роС->3е1ес+06] ест (СЕопт : : РгомНапа1е (м_п019Ропт)); 
} 


— 


// т_рРг1п{Роп{ удаляется в деструкторе СМу\М1ем 


Внимание! Будьте осторожны при удалении объекта, указатель на который 
возвращает 5еесЮБес!. Если вы создали этот объект сами, то вправе 
удалить его. Если же указатель временный, что бывает с объектами, пер- 
воначально выбранными в контекст устройства, то объект С++ удалять 
нельзя. 


Шрифты 


Старым приложениям текстового режима был доступен вывод текста только уны- 
лым системным шрифтом. У/Лп4о\з предоставляет массу шрифтов переменного 
размера, не зависящих от устройств вывода. Шрифты УЛп9о\$ позволяют улуч- 
шить внешний вид приложения без особых усилий со стороны программиста. 
Шрифты ТгиеТуре, появившиеся в УЛп9о\$ 3.1, еще эффективнее, и с ними про- 
ще работать, чем с зависимыми от устройства шрифтами, которые применялись 
ранее. Ниже вы познакомитесь с несколькими примерами программ, в которых 
используются различные шрифты. 


Шрифты как СО|-объекты 


Поддержка шрифтов встроена в СП! УЙп4о%5. Это означает, что шрифты — та- 
кие же объекты СПУ, как другие. Выводимый текст можно масштабировать и об- 
резать, а шрифты можно выбирать в контекст устройства аналогично перу или 
кисти. Все правила СПГ относительно отсоединения от контекста и удаления при- 
менимы и к шрифтам. 


Выбор шрифта 


Вы можете выбирать из двух типов шрифтов: независимых от устройства (ТгиеТуре) 
и зависимых, таких как 5узет, системный шрифт \Итао\'з для дисплея, и шрифт 
ИпеРгицег для принтеров Газег]е". Есть и третий путь — задать семейство шриф- 
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тов и размер, предоставив \Лп40\у$ самой выбрать шрифт. В последнем случае 
при первой возможности будет выбран шрифт ТгиеТуре. В библиотеке МЕС есть 
диалоговое окно выбора шрифта, связанное с выбранным в настоящий момент 
принтером, поэтому «угадывать» шрифт для принтера практически не надо. Вы 
позволяете пользователю выбрать для принтера шрифт и его размер и добивае- 
тесь отображения на дисплее, максимально приближенного к этому выбору. 


Шрифты и вывод на печать 


Для приложений, интенсивно работающих с текстом, размеры шрифта вы скорее 
всего будете задавать в пунктах (1 пт = 1/72 дюйма). Почему? Большинство, если 
не все, внутренних шрифтов принтеров определено в терминах пунктов. Так, шрифт 
Газе ет лпеРгииег поставляется с единственным размером 8,5 пт. Шрифты семей- 
ства ТгаеТуре доступны с произвольным размером в пунктах. При использовании 
пунктов для преобразования координат вам потребуется соответствующий режим — 
ММ_ТУТР5. В этом режиме размер 8,5 пт соответствует 170 (8,5х20) твипов — та- 
кой размер символа и следует задать. 


Отображение шрифтов на дисплее 


Если вас не беспокоит точное соответствие изображений на дисплее и на прин- 
тере, вы вправе выбрать любой из масштабируемых шрифтов ТгиеТуре или же 
системные шрифты фиксированного размера (стандартные СО1-объекты). При 
работе со шрифтами ТгиеТуре режим преобразования координат не имеет осо- 
бого значения — просто выберите нужную высоту шрифта. Заботиться о пунктах 
не нужно. 

Подбор соответствия шрифтов принтера, так чтобы изображение на экране 
точно соответствовало изображению на бумаге, сопряжен с определенными слож- 
ностями, однако шрифты ТгаеТуре облегчают эту задачу. Но даже если при печа- 
ти вы используете шрифты ТгиеТуре, абсолютного соответствия изображений на 
дисплее и на бумаге все равно не добиться. Почему? Символы в конечном счете 
изображаются с помощью пикселов (или точек), и длина строки символов равна 
сумме ширин отдельных символов в пикселах, возможно, с поправкой на кернинг. 
Ширина символа в пикселах зависит от шрифта, режима преобразования коор- 
динат и разрешающей способности устройства вывода. Точное соответствие было 
бы возможно, только если бы и для принтера, и для дисплея использовался ре- 
жим ММ_ТЕХТ, в котором один пиксел в точности равен одной логической еди- 
нице. Если для вычисления мест переноса строки применить функцию СОС::Се!- 
ТежЕжет, места переноса на экране могут иногда отличаться от мест переноса 
на принтере. 
анна 
Примечание В режиме предварительного просмотра (Рите Ргеме\), который 

мы рассмотрим в главе 15, переносы на новую строку происходят в тех 
же местах, что и на бумаге, однако качество отображения в окне пред- 


варительного просмотра при этом страдает. 
а Е О И" 


Если вы захотите отобразить текст на экране шрифтом, близким к внутренне- 
му шрифту принтера, технология ТгиеТуре облегчит и эту задачу. \Лп4о\ под- 
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ставляет наиболее близкий шрифт ТгаеТуре. Для шрифта Мпергииег УЛпдоу$ очень 
точно подставляет свой шрифт Социег Мех. 


Логические и физические дюймы на дисплее 


Функция-член СОС СеешясеСар$ возвращает параметры дисплея, важные для 
программирования графики. Шесть следующих параметров (табл. 6-1) предостав- 
ляют информацию о размере экрана (указаны значения для типичной видеокар- 
ты, сконфигурированной в \/т4оууз МТ 4.0 для разрешения 640х%480 пикселов). 


Таблица 6-1. Логические и физические дюймы 


Номер параметра Описание Значение 
НОК2$Е Физическая ширина в мм 320 
УЕКТУЕ Физическая высота в мм 240 
НОКРВЕ$ Ширина в пикселах 640 
УЕКТЮЕ$ Высота в растровых линиях 480 
[ОСРХЕХ Горизонтальное разрешение 96 


в точках на логический дюйм 


[ОСЫХЕ$У Вертикальное разрешение 96 
в точках на логический дюйм 


Числа НОКАЗЕ и УЕКТУЕ представляют физические размеры дисплея. (Эти 
значения могут отличаться от действительных, так как УЛл4оуУу$ «не знает» раз- 
мера монитора, подключенного к видеоадаптеру.) Размер дисплея можно вычис- 
лить, разделив соответственно НОКРКЕ$ или УЕКТКЕ$ на ГОСРЫХЕГ5Х или ГОСЫХЕГ$У. 
Полученные таким образом размеры называются логическими (1юз1са! $12е) дис- 
плея. Используя представленные выше значения и зная, что в дюйме 25,4 мм, можно 
легко вычислить размеры экрана в разрешении 640х%480 пикселов для УЛп4о\уз 2000 
и \УЛпаоу’з ХР. Физический размер дисплея равен 12,60Х9,45 дюйма, а логический — 
6,67х5 дюймов. Таким образом, физический и логический размеры экрана могут 
различаться. 

В УЛпао\ 2000/ХР НОКИЗУЕ и УЕКТУЕ не зависят от разрешения дисплея, а 
1ОСЫХЕГЯХ и ГОСЫХЕГ$У всегда равны 96. Поэтому с изменением разрешения 
изменяется логический размер, но не физический. 

В режиме преобразования координат с фиксированным масштабным множи- 
телем, будь то ММ_ШМЕТЕГС или ММ_ТУТР5, драйвер дисплея использует для пе- 
ресчета физический размер дисплея. Таким образом, в УЛюо\5 2000/ХР на мо- 
ниторе меньшего размера текст также получается меньше, но это не то, чего бы 
нам хотелось. Напротив, нужно, чтобы размеры шрифта соответствовали логичес- 
кому, а не физическому размеру дисплея. 

Можно создать специальный режим преобразования координат — режим ло- 
гических твипов (юз1са| 1\1р5), в котором одна логическая единица равна 
1/1440 логического дюйма. Этот режим не зависит от ОС и разрешения монито- 
ра и используется такими программами, как М!сгозой ога. Следующий код уста- 
навливает режим преобразования в логических твипах: 


р0С->5е{МарМоде (ММ_АМТЗОТВОРТС); 
роС->5е{М1пдомЕх{( 1440, 1440); 
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роС->Зе{\М1емрогтЕх+ (р0бС->бебеу1себарз (ГОбРТХЕЕЗХ), 
- рОС->ае{0еу1сеСарз (1ОСРТХЕЕ$У)); 


поновее вании 

Примечание Как размер шрифта, так и разрешающую способность дисплея 
можно настроить из УЛп4о\5 Сопиго| Рапе! (Панель управления). Если 
изменить размер шрифта дисплея со стандартных 100% на 200%, то 
НОКАЗ2Е становится равным 160, УЕКТ$7Е — 120, а число точек на 
дюйм — 192. В этом случае логический размер делится на 2, и размер 
текста, выводимого в режиме отображения «логические твипы», увели- 
чивается вдвое. 


Вычисление высоты символа 


СРОс-функция СеЙежМейчс$ возвращает 5 параметров высоты шрифта, из которых 
важны только 3 (рис. 6-1): йиНе@ задает полную высоту шрифта, включая ниж- 
ние выносные элементы для букв (2, }, р, 4иу) и диакритические значки поверх 
заглавных букв; инЕметпаЦеайтв задает расстояние между верхом диакритичес- 
кого значка и низом нижнего выносного элемента с предыдущей строки; сумма 
тНевИ и ипЕметпаЦеа@тв задает общую высоту символа. Значение ииЕжетпа/- 
[еаатв может равняться 0. 


Диакритический значок 


1тЕЖегта!еад тд 
1т/тега! вадтд 


утНедт 
Истинная высота Ч 


Нижний 
выносной элемент 


Рис. 6-1. Размерные параметры шрифта 


Вы можете предположить, что ййНеей задает высоту шрифта в пунктах. Это 
совершенно неверно! Здесь вступает в игру параметр йтйиегпаПеайть, возвра- 
щаемый функцией СеЙехМейтсх. Высота в пунктах соответствует разности меж- 
ду тНевЫ и титетпаЙеатв. В режиме преобразования координат ММ_7Р$ 
выбранный в контекст шрифт в 12 пт может иметь значение ииНеюй1, равное 295, 
а иириетпа!еат — 55 логическим единицам. Тогда истинная высота шрифта, 
равная 240, соответствует высоте в 12 пт. 


Пример ЕхОба 


В этом примере для окна представления устанавливается режим преобразования 
координат «логические твипы». Программа выводит текстовую строку ТгаеТуре 
шрифтом Ана| высотой 10 пт. 
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1. Стенерируйте проект Ех0ба с помощью МЕС АррИ/са оп \/2аг4. После- 
довательно выберите в меню ЕЙе команды Ме\ и Рго}есе. В качестве типа при- 
ложения укажите МЕС АррИсаНоп. На странице АррИсайоп Туре мастера уста- 
новите переключатель в положение $1п1е доситепь а на странице Адуапсеа 
Ееагагез сбросьге флажок РипИпз апа рип: рге\1еу. Остальные параметры ос- 
тавьте без изменения. 

2. С помощью окна Ргорег4е$ утилиты С1а5$ Улеуу переопределите функ- 
цию ОпРгерагерс в классе СЕхОбаЙеи». Измените код в файле ЕхОба\1еуусрр: 


\0149 СЕхОба\1ем: :ОпРгерагеббС(СОС» роб, СРг1иТпРо *рТпто) 
{ 
роС->5е{МарМоде(ММ_АМТЗОТВОРТС); 
роС->$е{М1пдомЕх{ (1440, 1440); 
роС->$е4{\/1емрог{Ех{ (р0б->бе{беу1сеСарз (ГОбРТХЕЕЗ$Х), 
- р0б-> бвефбеу1сеСарз (1О@РТХЕЕ$У)); 
} 


3. Добавьте закрытую вспомогательную функцию 5рошЕот! к классу «вид». 
Создайте показанный ниже прототип в ЕхОба\1е\/.П: 


рг1уате: 
№019 ЭпомРоп{(СОС» роб, 1п1& пРоз, 11 пРо1п{$); 


Затем добавьте саму функцию в файл ЕхОба\1е\..срр: 


№019 СЕхОба\1ем: : ЗпомЕРоп*(С0С* р0С, 1п%& пРо$, 1п{ пРо1п{$) 
{ 

ТЕХТМЕТВТС \п; 

СРопЕ  Коп%Техе; 

С31г1п9  зЕгТехе; 

(0$17е 3127еТех; 


Топ{Техе. СгеафеРоп* ( -пРо1п{$ * 20, 0, 0, 0, 400, РАЕЗЕ, РАЕЗЕ, 0, 
АМЗТ_СНАВЗЕТ, ОУТ_ВЕРАЦЕТ_РВЕСТ$, 
СЕТР_ОЕРАУЕТ_РВЕСТ$, ОЕРАУЕТ_ОУАЕТТУ, 
БЕРАЦЕТ_РТТСН | РЕ_$М155, “Аг1а1"); 

СЕопт* р019Еопе = (СРопф*) рОС->$е1ест06]ес+ (&РоптТех{); 

р0С->бе{Тех{Ме{г1с$ (&1т); 

ТВАСЕ("ро1пт$ = %а, {мНетопе = %4, (тТГиегпа1\еад1т9 = %9," 

” 1иЕхфегпа11еа91п = %а\п", пРо1пт$, т, +тНе19пе, 
{т. +иТиегпа1(еад1пд, \м. {мЕхегпа11еа91п9); 

зфгТех+. Рогта* ("Ти1$ 1$ %9-р01п+ Аг1а1", пРо1п{$); 

э17еТехе = р0б->бетТехчЕхтеп* (з+гТех{); 

ТВАСЕ( "$4 г1пд м1ЧИ = %4, $3%г1п9 пе19й{ = %4\п", $17еТехе.сх, 

$17еТехе.су); 

роС->Техе0и*(0, пРоз, з{гТехт); 

роС->5е1ест06)ест(р019ЕРопт); 

пРоз -= м. {мНезди{ + Тм. +тЕх{егпа1(еа911п9; 

} 


4. Отредактируйте функцию Оп)гаи в Ех0баУ1еуу.срр. МЕС АррИсаНоп УЙтага 
всегда создает для класса «вид» шаблон функции Оп)гаи. Замените ее текст на: 
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\014 СЕхОба\М1ем: :Оп0гам(С0С»* рос) 


{ 
11 пРо$1{10п = 0; 


Рог (1111=6; 1 <= 24; 1+=2) { 
ЗпомРопЕ(роС, пРоз11оп, 1); 

} 

ТВАСЕ( “ГОбРТХЕЕЗХ = %4, 1ОбРТХЕЕЗУ = %а\п”, 
роС->бе{Оеу1сеСарз (106РТХЕЕЗХ), 
роС->бе{О0е\у1сеСарз(1ОбРТХЕЕ$У)); 

ТВАСЕ( "НОВ2ЗТ7Е = %4, МЕВТЗТИЕ = Ха\п", 
роС->бе{О0еу1сеСарз(НОВ7$Т7Е), 
роС->бе{О0е\у1сеСарз(МЕВТ$Т7Е)); 

ТВАСЕ("НОВ2ВЕ$ = %а, УЕАТВЕЗ = %а\п”, 
роС->бе{Оему1сеСарз (НОВ7ВЕ$), 
роС->бе{О0еу1сеСарз(МЕВТВЕ$)); 

} 


5. Соберите и запустите программу Ех0ба. Чтобы наблюдать за выводом, ге- 
нерируемым операторами ТКАСЕ, программу нужно запускать «в отладчике». 
Выберите пункт 51а из меню РеБиз в \У15иа! С++ МЕТ, нажмите клавишу Е5 или 
щелкните на панели инструментов кнопку СопИпие: 


Резульгат работы программы (если используется стандартная видеоплата 
УСА) будет примерно таким: 


15$ {$ 12-роЕ Апа! 
Що 5 14-ро Апа! 

5 5 18-ротЕ Апа! 

[$ 1$ 20-ротЁ Апа! 
61$ 1$ 22-рош{ Апа! 
55$ $ 24-ротЁ Апа! 


Обратите внимание: размеры выведенных строк не совсем точно соответствуют 
размерам в пунктах. Несоответствие возникает при преобразовании логических 
координат в пикселы, выполняемом подсистемой шрифтов (ЮпЕ епете). Отла- 
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дочные данные, фрагмент которых вы видите ниже, показывают параметры шриф- 
тов. (Точные цифры зависят от конкретного драйвера дисплея и видеодрайвера.) 


ро1п{з = 6, {мНе1ойт = 150, 1тТпфегпа11еа91п9 = 30, 1тЕхтегпа11еа91п9 = 4 
$г1п9 мати = 990, ${г1пд Петдйе = 150 
ро1п{$ = 8, тмНе1дпе = 210, 1тТптегпа11еа91п9 
3г1п9 мати = 1380, $1г1пд Пе1дй{ = 210 
ро1п{$ = 10, тмНезойе = 240, {тТптегпа11еа91п9 = 45, 1мЕхфегпа1еа91п9 = 6 
${г1п9 млафп = 1770, ${г1пд Пе19пе = 240 
ро1п{$ = 12, 1мНе19й{ = 270, ттГпфегпа1Ееа91п9 
31г119 м19{П = 2130, ${г1пд Пе19пе = 270 


И 
($ 


45, ттЕхтегпа11еа91п9 


Н 
со 


30, тмЕхтегпа11еа91п9 


Элементы программы Ех0ба 


Далее мы обсудим важнейшие элементы программы ЕхОба. 


Установка режима преобразования координат в функции ОпРгерагерС 


Функцию ОпРгерагерС вызывает каркас приложения перед вызовом функции 
Оп)гаш», и потому в ней логичнее всего готовить контекст устройства для Оп)гаш. 
Если установка режима преобразования координат требуется другим обработчи- 
кам сообщений, эти обработчики могут вызывать ОпРгерагерс. 


Закрытая функция-член Зпои/Рот 


ЗрошЕотЕ содержит код, исполняемый в цикле 10 раз. В программе на С эта функ- 
ция была бы глобальной, но в С++ лучше сделать ее закрытым членом класса. Иногда 
такие функции называют вспомогательными (Берег Рапсйоп). 

Функция создает шрифт, выбирает его в контекст устройства, выводит строку 
в окно и отключает шрифт от контекста устройства. В отладочном варианте про- 
граммы она также выводит сведения о параметрах шрифта, в том числе истин- 
ную длину строки. 


Вызов СРопЁ:СгеаеРот 


У этой функции масса параметров, но наиболее важны первые два: высота и ши- 
рина шрифта. Нулевая ширина означает, что отношение ширины знаков к высо- 
те (азресЕ гайо) шрифта установлено равным значению, определенному разра- 
ботчиком шрифта в качестве значения по умолчанию. Если указать ненулевое 
значение, то, как вы увидите в следующем примере, это отношение изменится. 


Совет Если нужно получить шрифт точно указанного размера в пунктах, за- 
дайте отрицательное значение высоты (первый параметр) в вызове фун- 
кции СтежщеЕРот. Так, если вывод на принтер осуществляется в режиме 
преобразования координат ММ_ТУ1Р5, значение высоты -240 гарантирует 
высоту шрифта в точности равную 12 пт, а йиНе®й Е - итиетпа!еайтв = 
240. Значение +240 даст меньший размер шрифта с йиНею 1, равным 240. 


Последний параметр СтешеЕот задает имя шрифта, в данном случае — Ана! 
(ТгаеТуре-шрифт). Если этот параметр равен МИШ, указание ЕЁ_57155 (что озна- 
чает пропорциональный шрифт без засечек) заставляет \Ип4о\у; выбрать наиболее 
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подходящий шрифт, которым в зависимости от конкретного размера оказывает- 
ся 5узет или Апа1. Если имя шрифта задано, этот параметр имеет преимущество 
перед другими. Если, скажем, вместе с Ана! указать ЕЁ_КОМАМ (что означает про- 
порциональный шрифт с засечками), система все равно выберет Ана|. 


Пример Ех0бЬ 


Эта программа похожа на ЕхОба, но использует несколько шрифтов. В ней при- 
меняется режим преобразования координат ММ_АМОТКОРГ с масштабом, кото- 
рый изменяется в зависимости от текущих размеров окна. Размеры символов из- 
меняются вместе с размером окна. Программа демонстрирует некоторые шриф- 
ты ТгиеТуре в сравнении со шрифтами старого типа. 


1. Сгенерируйте проект ЕхО6Ь с помощью МЕС АррНсаНоп У\71тага. На стра- 
нице АррНсаНоп Туре мастера установите переключатель в положение шее 
Чоситепь, а на странице Адуапсе4 Ееагигез сбросьте флажок Рипипе апа рип 
ргемлеу. Остальные параметры оставьте без изменения. 


2. Используя окно Ргорег{е$ утилиты С!а$$ У4е\у переопределите функ- 
цию ОиРгерагеОС в классе СЕХОбЬИеи,. Измените код в файле ЕхОбЬ\еуусрр: 


\014 СЕхОбо\1ем: :ОпРгерагебС(С0С»* роб, СРизпТпРо* рТпто) 
{ 
СВесЕ с11епВес*; 


(е{С11еп{Вес+(с11епВесе); 
роС->$е{МарМоде(ММ_АМТЗОТАОРТС); // ось у направлена вниз 
роС->$е+М1пдомЕхЕ(400, 450); 
роС->5е1\/1емрогЕЕх*(с11епЕВес+. г19п{, с11епВес+. Боом); 
роС->5е+\У1емрог{0га(0, 0); 

} 


3. Добавьте к классу «вид» закрытую вспомогательную функцию Тгасе- 
Мей“с$. Добавьте в ЕхОбЬ\1е\/.В прототип: 


рг1уате: 
\019 ТгасеМефг1с$(С9С* рос); 


Затем добавьте саму функцию в ЕхОбЬ\е\у.срр: 


\014 СЕхОбБ\1ем: : ТгасеМметг1с$(С06* рос) 
{ 

ТЕХТМЕТВТС 1п; 

спаг 57ЕасеМате[ 100]; 


роС->бе{Тех{Метг1с$ ( &1т); 

роС->бетТех{Расе(99, з2ЕасеМаме); 

ТВАСЕ("Роп{ = %$, 1тНезойе = %4, {мТптегпа11еа91пд = %а, " 
`° {мЕХ{егпа11еа01п9 = %9\п", з2РасеМате, \т. +тНезаи\, 
{т. пТотегпа1(еа91п9, 1м. {мЕх{егпа11еа41па); 
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4. ` Отредактируйте функцию ОпОгаи в Ех0бЬ\У4е\у.срр. МЕС АррИсаноп УЯ2ага 
всегда создает для класса «вид» шаблон функции Оп)гаш.. Замените ее текст на: 


\014 СЕхобЬ\1ем: :ОпО9гам(С0С» роб) 


{ 


} 


СРопЕ ТопфТез{1, ГопфТез{2, РоптТез{3, ГоптТез{4; 


Топ{Тез+1 .СгеатеРоп{(50, 0, 0, 0, 400, РАЕЗЕ, РАЕЗЕ, 0, 
АМЗТ_СНАВЗЕТ, ОУТ_ОЕРАЦЕТ_РВЕСТ$З, 
СЕТР_ОЕРАЦЕТ_РВЕСТ$, ОЕРАУЕТ_ОУАЕТТУ, 
БЕРАЦЕТ_РТТСН | ЕЕР_$М1$$, “Аг1а1”); 

СРопе* р01аРопф = р0б->5$е1ес+06]ес+( &РоптТез+1); 

ТгасеМетг1с3(р0С); 

роС->Тех+0и*(0, 0, ” ТН1$ 13$ Аг1а1, деРаи1 мала “”); 


Топ1Тезт2. СгеафеРоп{(50, 0, 0, 0, 400, РАШЗЕ, РАЁЗЕ, 0, 
АМЗТ_СНАВЗЕТ, ОУТ_ОЕРАЦЕТ_РВЕСТЗ, 
СЕТР_ОЕРАУЕТ_РВЕСТ$, ОЕРАУЕТ_ОЦАЕТТУ, 
ОЕРАЦЕТ_РТТСН | РЕ_МОБЕВМ, “Соиг1ег“); 
// шрифт не из семейства ТгиеТуре 

роС->5е1ест06] ест (&Роп{Тезт2); 

ТгасеМетг1сз(р0С); 

роС->Техе0и{(0, 100, “Т№1з 13 Соиг1ег, деРаи1{ млатп”); 


Топ{Тез{3 . СгеатеРоп{(50, 10, 0, 0, 400, РАЁЗЕ, РАЁЗЕ, 0, 
АМЗТ_СНААЗЕТ, ОУТ_ОЕРАЦЕТ_РВЕСТЗ, 
СЕТР_ОЕРАЦЕТ_РВЕСТ$, ОЕРАЦЕТ_ОУАЕТТУ, 
ОЕРАЦЕТ_РТТСН | РЕ_ВОМАМ, МИ); 

роС->5е1ест0Ь] ес+ (&Роп{Тез{3); 

ТгасеМетг1с3(р0С); 

роС->ТехЕ0и{(0, 200, “"Тп1з 1$ депег1с Вотап, уаг1аб1е м1а+п”); 


Топ1Тез+4. СгеатеРоп{(50, 0, 0, 0, 400, РАЁЗЕ, РАШЗЕ, 0, 
АМЗТ_СНАНЗЕТ, ОУТ_ОЕРАУЕТ_РВЕСТЗ, 
СЕТР_ОЕРАЦЕТ_РВЕСТ$, ОЕРАЦЕТ ОУАЕТТУ, 
ОБЕРАЦИТ_РТТСН | ЕЕ_МООЕВМ, “11пеРг1птег”"); 

роС->$е1ес+06] ест (&Роп{Тез14); 

ТгасеМметг1с$(р0С); 

р0С->Тех+0и{(0, 300, “Тп1$ 13 ЕпеРрг1пфег, деРаи1 м1атп”); 

роС->5е1ес{06] ест(р019Роп*); 


5. Соберите и запустите программу Ех06Ъ. Чтобы видеть вывод, генерируе- 
мый операторами ТКАСЕ, запустите программу «из-под отладчика». Окно про- 
граммы показано на рисунке. 
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Ты {$ Апа!, Четаий ммс 
115 15$ Соцг1ег, 4еЁац1% ч1афь 


1$ 15 вепепс Котап, уачае ул 


т51$ 15$ ПЛперк1ипфек, ЯеЁаи1е и1аев 


Уменьшите размеры окна и проследите, как меняется размер шрифтов. 
Сравните это окно с показанным выше. 


1$ 1$ Соцг1ег, Чеёау1& чз В 


3 45 ЕЕежЬюях<- Е <>жкагажь. 72а 4:1>1« Зла <ажть 


43 13 [1перкфисек, ЧеЁал1с узась 


Продолжайте уменьшать окно: размер шрифта Соипег по достижении неко- 
торого минимума перестает меняться. Последите также за изменением ширины 
шрифта Котап. 


Элементы программы Ех0бЬ 


Далее обсуждаются важнейшие элементы примера ЕхОбЬ. 


Функция-член ОпОгаи/ 

Эта функция выводит в окне строки с использованием четырех разных шрифтов: 

Ш /211е511 — шрифт Ана! типа ТгаеТуре со стандартной шириной; 

Ш /0’/1е542 — шрифт Соипег старого типа со стандартной шириной; обратите 
внимание на неровные края букв при болыпом размере шрифта; 

Ш /оие93 — типовой шрифт Котап, вместо которого УЛп4о\ $ использует Тгие- 
Туре-шрифт Типез №еуу Вотап с программным выбором ширины; ширина свя- 


зана с горизонтальным размером окна — шрифт будет растягиваться так, что- 
бы строка занимала всю ширину окна; 


Ш /07112514 — в программе задан шрифт МпеРгииет, но, поскольку он не является 
шрифтом УЛпао%$ для дисплея, подсистема шрифтов, руководствуясь парамет- 
ром ЕЁЕ_МОРЕКМ, выберет ТгаеТуре-шрифт Соипег Ме. 


Вспомогательная функция ТгасеМей"с$ 


Вызвав СОС::беЙехМейтс; и СОС;:СейежмЕасе, эта функция получает параметры 
текущего шрифта, которые затем отображает в окне отладки. 
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Пример Ех0бс: снова СЗсго!Меи 


Мы уже встречались с классом С5стоИЙеи в главе 5 (пример Ех05с). В ЕхОбс ис- 
пользуется окно с прокруткой и режимом преобразования координат ММ _ГОЕМ- 
СИ5Н, что позволяет пользователю перемещать эллипс мышью, применяя «захват» 
мыши. Прокрутка с клавиатуры не реализована, но вы можете добавить ее, «одол- 
жив» функцию ОйиКеуроши из Ех05с. 

Вместо стандартной кисти мы задействуем для эллипса трафаретную кисть 
(рацегп Бги$В) — настоящий СО1-объект. С этим связана одна сложность: после 
прокрутки окна нужно переустанавливать начальную точку, иначе полосы трафа- 
рета не совпадут, и результат будет выглядеть довольно уродливо. 

Как и в ЕхО5с, здесь используется класс «вид», производный от С$стоШИе. 

1. Спомощью МЕС АррИсаНоп У/12аг4 создайте проект Ех0бс. На странице 

АррИсайоп Туре мастера установите переключатель в положение ше доситепь, 

а на странице Адуапсеа Ееагоге$ сбросьте флажок РипИпе апа рипе ргеяеху. Не 

забудьте выбрать в качестве базового класса СустоШ/е. 

2. Отредактируйте заголовок класса СЕхОбс\еи; в файле ЕхобсУ1еу.5. В 
объявление класса СЕхОбсИЙеи› добавьте строки: 


рг1\уате: 
Сопзф С512е м_$17еЕ111р$е; // логические 
СРо1п{ п_ро1пТорЕе!еЕ; // логические, верхний левый угол 
// прямоугольника эллипса 
($17е м_317е01Рзет; // физические, смещение от верхнего левого 


// угла прямоугольника до точки захвата мыши 
ВОО тм_ОСартигед; 


3. Вокне (1а$$ Уле\уу выберите класс СЕхОбсИеи и в окне Ргорегие$ добавьте 
в него три обработчика событий. Добавьте обработчики: 


Сообщение Функция-член 
УМ ВИТТОМРОУМ ОтВийопроит 
УМ 1ВИТТОМОР ОтВийоп0р 
УМ _МОПЗЕМОУЕ ОпМоизеМоье 


4. Отредактируйте функции-обработчики сообщений в классе СЕхОбсИеи.. 
Шаблоны этих функций сгенерировал мастер С!аз$ У1е\\ на предыдущем эта- 
пе. Найдите эти функции в ЕхОбс\1е\уусрр и поместите в них код: 


019 СЕхОбс\1ем: :ОпЕВи{Топбомп(УТМТ пЕ1адз, СРо1пф ро1ит) 
{ 
СВесф гестЕ111рзе(т_ро1пЕТорЕе!+Е, м_317еЕ111рзе); // все еще логические 


// координаты 
СВадп с1гс1е; 


СС11еп{0С 9с(1181$); 

ОпРгерагеоС( &4с); 

9с. ЕРЕо0Р( гестЕ111рзе); // теперь в аппаратных координатах 
с1гс1е. СгеатеЕ111р+1сВдпТпа1 гест( гес{Е111рзе); 

1{ (с1гс1е. РЕТпАе91оп(ро1п*)) { 
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————_———_———————„/Э„—АЗААА/—/—/——/—’—’А—Ч/А 


// захватывая мышь, мы уверены в последующем появлении сообщения ЕВи опр 
ЗетСарфиге(); 

м_БОСарфигед = ТВИЕ; 

СРо1пЕ ро1пТорЕе!(т_ро1пЕТорЕет+); 

дс. ЕРфо0Р( &ро1п{ТорЕе{ +); 

п_$12е07Рзе{т = ро1пф - ро1пЕТорЕе{т{; // аппаратные координаты 

// на время захвата мыши изменяем ее курсор 

: : ЗеСигзог( ; : Гоадбигзог(МИЕЁ, Т0С_С80$$)); 


} 


У019 СЕхОбс\1ем: : ОпЕВиопир(ИТМТ пЕ1адз, СРо1пе ро1п{) 
{ 
11 (м_ЬСарфигеа) { 
:: Ае1еазеСартиге(); 
п_6Сарфигед = РАЕЗЕ; 


} 


У019 СЕхОбс\1ем: :ОпМоизеМоуе (ИТМТ пЕ1адз, СРо1пе ро1пт) 
{ 
11 (м_ОСартигеа) { 
СС11еп0С 9с(111$); 
ОпРгерагеоС( &9с); 
СВест гест014(т_ро1пЕТорьеРЕ, м_312еЕ111рзе); 
9с. ЕРЕоОР( гес1014); 
Тпуа11дафевест( гест014, ТВИЕ) 
п_ро1п{ТорЕегЕ = ро1пЕ - м_$12е0тЕзет; 
дс. ОРЕоЕР(&т_ро1пТоргете); 
СВесЕ гест№м(т_ро1пЕТорЕеРЕ, м_$17еЕ111рзе) 
9с. ЕРЕоОР( гес+№ м); 
Тпуа11дафевест( гесЕ№ м, ТВИЕ); 


} 


Отредактируйте конструктор класса СЕхОбсИеи, функции ОпОгаи и 
Оппианеа раме. Шаблоны этих функций сгенерированы МЕС АррИсаНоп 
УЛ гага. Найдите их в ЕхОбс\1еусрр и поместите в них такой код. 


СЕхОбс\У1ем: :СЕхОбс\1ем() :т_312еЕ111рзе(100, -100), 
м_ро1пТорьет{(0, 0), 
м_312е011зе{(0, 0) 
{ 
т_БСарфигед = РАЕЗЕ; 
} 


\019 СЕхОбс\У1ем: :ОпОгам(С0С* р0С) 
{ 
СВгизй БгизННафсв(Н$_ОТАбСАО$$, В6В(255, 0, 0)) 
СРо1п{ ро1пт(0, 0); // логическая точка (0, 0) 


роС->ЕРЪорР( &ро1п+); // переход к аппаратным координатам 


ГЛАВА 6 Классические СО!-функции, шрифты и растры 93 


рос->5е{ВгизпОга(ро1п*); // для выравнивая трафарета кисти 
// по начальной точке окна 
роС->5е1ес+06]ес+( &6гизПНатсп); 
роС->Е111рзе(СВес*(п_ро1пТорьет+, т_$12еЕ111рзе)); 
роС->$е1есЕ$ФоскОБ] ест (ВЕАСК_ВВИЗН); // отсоединяем БгизПНатсп 
роС->Вестапд1е(СВес+(100, -100, 200, -200)); // объявляем прямоугольник 
// недействительным 


№019 СЕхОбс\1ем: : ОпТп1{1а10рдате() 
{ 


(С3сго11\1ем: :Оп1п111а10рдате() 


С$17е 312еТофа1(800, 1050); // 8х10,5 дюймов 

С312е 317еРаде(312еТофа1.сх / 2, $312еТофа1.су / 2); 

С312е $17е11пе(312еТофа1.сх / 50, 317еТофа1.су / 50); 

3е15сго11$12ез(ММ_ГОЕМСЕТ$Н, 312еТофа1, 31хеРаде, $312е1пе); 
} 


6. Соберите и запустите программу Ех0бс. Программа поддерживает перетас- 
кивание эллипса мышью и прокрутку изображения в окне. Окно программы 
должно выглядеть примерно, как на рисунке. При перемещении эллипса сле- 
дите за черным прямоугольником. Вы должны заметить характерное поведе- 

ние, когда изображение прямоугольника становится «недействительным». 


Элементы программы Ех0бс 


Ниже обсуждаются важнейшие элементы примера ЕхОбс. 


Переменные-члены т_$еЕШрзе и т_ротЁТорЁеН 


Вместо того чтобы хранить ограничивающий прямоугольник эллипса в одном 
объекте СКеср, программа раздельно хранит размер (из_52еЕШрзе) и положение 
левого верхнего угла этого прямоугольника (72 рот орГер). Чтобы переместить 
эллипс, программе достаточно заново вычислить 772 ротИоргей, при этом погреш- 
ность округления не влияет на размер эллипса. 


94 Часть И Основы МЕС 
Ым——_—_ 


Переменная-член т. $2е0Н5е! 


Когда функция ОиМоизеМоге перемещает эллипс, относительное положение ука- 
зателя мыши внутри эллипса должно оставаться неизменным с того момента, когда 
пользователь нажал левую кнопку. В переменной т_51еО[5е! хранится первона- 
чальнос смещение мыши относительно левого верхнего угла прямоугольника 
эллипса. 


Переменная-член т_ЬСаршгеа 


Эта логическая переменная устанавливается в ТКОЕ на время выполнения оперла- 
ции перемещения эллипса мышью. 


Функции 5е{Саршге и Ре!еазеСаршге 


Функция 5еСарите класса Спа захватывает мышь, после чего сообщения о пе- 
ремещении мыши посылаются только в данное окно, даже если указатель мыши 
выйдет за его пределы. Нежелательный побочный эффект состоит в том, что эл- 
липс может выйти за пределы окна и «потеряться». Желательный и необходимый 
эффект — то, что все последующие сообщения мыши, в том числе УМ ГВИТТОМИР 
(которое иначе было бы потеряно), теперь посылаются нашему окну. Функция 
\/1п32 КееазеСарите снимает захват мыши. 


\т32-функции $еЁСигзог и [оааСигзог 


Некоторые функции \Л1п32 не имеют эквивалентной «обертки» в библиотеке МЕС. 
По соглашению мы используем оператор разрешения области действия С++ © 
при вызове функций \/1132 напрямую. В этом случае вероятность конфликта имен 
с функцией-членом класса СИеш исключена, но всегда можно вместо функции- 
члена класса вызвать одноименную функцию \/1132. При этом оператор :: га- 
рантирует, что вызывается именно глобальная \/т32-функция. 

Если первый параметр равен МИЛ, Гоа@Ситзог создает ресурс-курсор (сигзог 
тезоигсе) из заданного стандартного курсора мыши У/пао\у. Функция 5еСитзот 
активизирует заданный ресурс курсора. Этот курсор остается активным, пока мышь 
захвачена. 


Функция-член С$сго!Меи::ОпРгерагер С 


Виртуальная функция ОпРгератерс в классе СИеи ничего не делает. В классе 
СустоТеи она переопределена и устанавливает режим преобразования и точку 
начала координат окна «вид» на основании параметров, переданных $е/5сто5{2ез 
в функции ОпийеЮрашще. Каркас приложения автоматически вызывает Опруе- 
ратерсС перед вызовом ОпОгаш, так что об этом заботиться не надо. Из любого 
другого обработчика сообщения, использующего контекст устройства окна пред- 
ставления, например, из ОВийопрошт и ОпМоизеМове, функцию ОпРгератерс 
придется вызывать самостоятельно. 


Преобразование координат в ОпМоизеМоуе 


Эта функция содержит несколько операторов преобразования. Алгоритм таков. 


1. Создать предыдущий описывающий прямоугольник эллипса и преобразовать 
его из логических координат в аппаратные. 


2. Сделать предыдущий прямоугольник недействительным. 
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5. Обновить координаты левого верхнего угла прямоугольника. 
4. Создать новый прямоугольник и преобразовать его в аппаратные координаты. 
5. Сделать недействительным новый прямоугольник. 


Функция вызывает моайашеКес дважды. \Лп90%$ «накапливает» недействитель- 
ные прямоугольники и вычисляет новый недействительный прямоугольник, пред- 
ставляющий собой пересечение объединения двух первых с клиентским прямо- 
угольником. 


Функция Опбгаи/ 


Вызов 5еВгизрОтв обеспечивает правильную перерисовку трафарета, применяе- 
мого для внутренней области эллипса, когда пользователь прокручивает изобра- 
жение в окне. Кисть выравнивается относительно точки, находящейся в левом 
верхнем углу логического окна и преобразованной в аппаратные координаты. Это 
важное исключение из правила, по которому параметрами функций-членов СОС 
служат логические координаты. 


Режим Зе са/еТоЕИ$!ге класса СЗсго!Мем 


Класс Сустоеи» поддерживает масштабирование по размеру окна. В этом режи- 
ме вся область прокрутки отображается в окне целиком. Применяется режим пре- 
образования координат ММ _АМ5ОТКОРГС с одним ограничением: положительные 
значения координаты у всегда возрастают при движении вниз, как в режиме ММ_ТЕХТ. 

Чтобы задействовать масштабирование по размеру окна, замените вызов 5$е1- 
$ст10й12е5 на: 


Зе{$са1еТоЕ11517е($17еТота1); 


Вы можете вызывать эту функцию по команде меню Вик го Й! («сжать по 
размеру окна») и реализовать таким образом переключение между режимом 
прокрутки и режимом масштабирования по размеру окна. 


Режим преобразования координат «логический твип» в окне с прокруткой 


МЕС-класс С5стоШИЙеи позволяет прибегать только к стандартным режимам пре- 
образования координат. В примере Ех17а в главе 17 представлен новый класс 
СТовбстоШеи», поддерживающий режим «логические твипы». 


Растровые изображения 


Без графических изображений УЛпао\з-программы выглядели бы довольно уныло. 
Иногда приложение вообще бесполезно без графики, но с рисунками любая про- 
грамма становится гораздо интереснее. Растровые изображения, или битовые 
карты (Биттар), УЛю4о\"$ — это массивы битов, представляющих растровые точки 
(пикселы) дисплея. Кажется, все очень просто, но, прежде чем применять растро- 
вые изображения для создания \У/Лп9о\5-приложений профессионального уров- 
ня, вам придется многому научиться. 

В этом разделе вы узнаете, как создавать аипаратно-независимые растровые 
изображения (Реусе-ша4ерепаепЕ Вйтарз, ОГВ$). ОТВ упрощает работу с цветами 
и принтером, а иногда позволяет добиться и более высокой производительнос- 
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ти. Новая \т32-функция СтешеГ/В$есйоп предоставляет все преимущества О]В в 
сочетании с возможностями растрового изображения СП]. 

Вы также узнаете, как размещать растровые изображения на командных кнопках, 
применяя МЕС-класс СВйтарвВийоип. Эта часть не связана с О1В, но прием этот очень 
полезен, и им очень трудно овладеть без примера. 


Растровые изображения СП! и ОВ 


Этот раздел посвящен в основном аппаратно-независимым растровым изображе- 
ниям (РВ). Намного больше о работе с ними вы узнаете из справочной системы 
М$ОМ комплекта ресурсов Р!аКогт $ОК. В \Итао\з два типа растровых изобра- 
жений: СО!-растр и ПИВ. Растровые изображения СП! используются уже давно, 
и за более подробной информацией о них обратитесь к соответствующей лите- 
ратуре. 

Класс СВйтар библиотеки МЕС представляет объект «растровое изображение 
СОБ. С этим объектом связана аппаратно-зависимая структура данных УЛп4о\%5, 
внутренняя для модуля СП1. Ваша программа может получить копию данных объек- 
та, но структура битов в ней зависит от конкретной аппаратуры дисплея. Растро- 
вые изображения СО! можно свободно передавать между разными программами 
на одном компьютере, но из-за аппаратной зависимости копировать их на дру- 
гой компьютер бессмысленно. 

Растровое изображение СП — это лишь один из СП]-объектов, таких как перо 
или шрифт. Поэтому вам достаточно создать растровое изображение, а затем 
выбрать его в контекст устройства. Закончив работу с растровым изображением, 
вы должны отключить его от контекста и удалить. Впрочем, это вы уже знаете. 

Однако есть одна особенность, связанная с тем, что «растровое изображение» 
на экране и принтере в действительности представляет собой поверхность экра- 
на или бумагу. Растровое изображение нельзя напрямую выбрать в аппаратный 
контекст дисплея или принтера — нужно позаботиться о создании специального 
контекста устройства в памяти (тетогу еусе сошехи) для растрового изоб- 
ражения. Для этого служит функция СОС::СтешеСотрайЫерс, а затем вызывается 
функция-член 5тесЬВИ или ВИВИ класса СОС, которая копирует контекст устрой- 
ства в памяти в контекст «реального» устройства. Такие «преобразующие» функ- 
ции обычно вызываются в функции Опргаш класса «вид». Естественно, по завер- 
шении работы вы должны не забыть очистить контекст устройства в памяти. 


Р1В-изображения имеют ряд преимуществ в сравнении с СОГ-растрами. По- 
скольку РВ содержит сведения о цвете, упрощается работа с цветовой палитрой, 
а также управление градациями серого цвета при печати. Любой компьютер под 
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управлением \/1п90%5 способен обрабатывать ОВ, которые обычно хранятся в 
виде дисковых ВМР-файлов или как ресурсы в ЕХЕ- и ОШ-файлах. В частности, 
фоновая картинка на вашем рабочем столе считывается при запуске УЛп4о\$ из 
ВМР-файла. Основным форматом хранения данных для программы \УЛп4о\$ Райи 
служит ВМР а У!51а1 С++ МЕТ использует ВМР-файлы для хранения изображений, 
например кнопок панелей инструментов. Есть и другие форматы обмена графи- 
ческими данными, например, ТТЕЕ ОТЕ или ]РЕС, но \1п32 АР! напрямую поддер- 
живает только формат О1В. 


Цветные и монохромные растровые изображения 


Существуют небольшие различия в обработке ОС УЛпао\з цветных растров и 
цветов кисти. Многие растровые изображения — 16-цветные. У обычной УСА-карты 
4 цветовых «плоскости», и для представления пиксела используется по одному биту 
в каждой. При формировании растрового изображения задаются 4-разрядные 
значения цвета. Таким образом, для обычной УСА-карты цвета растрового изоб- 
ражения ограничены 16 стандартными цветами. Смешанные (Айегеа) цвета в 
растровых изображениях не применяются. 

В монохромном растровом изображении лишь одна плоскость. Каждый пик- 
сел представляется одним битом, значения которого принимают одно из двух 
значений: 1 (включен) или 0 (выключен). Цвет текста задает функция СОС::5е1- 
Пехкоют, а фона — функция Зе ВЁСо/от. Оба цвета позволяет определить УЛп4о%- 
макрос КОВ. 


О1В-изображения и класс СО 


В МЕС есть класс СВйтар для @ПГ-растров, но класса для ОТВ нет. Не волнуйтесь, 
вы его получите. Это полностью переработанный класс СГ из предыдущих из- 
даний этой книги (до 4-го издания). В нем задействованы все преимущества та- 
ких средств \Лп32, как проецирование файлов в память, улучшенное управление 
памятью и О1В-секции. Включена и поддержка палитр. Однако прежде, чем изу- 
чать класс СО, познакомимся с ОТВ поближе. 


Несколько слов о программировании палитры 


Программировать палитру в УЛп9о\$ очень сложно, но дело с ней придется иметь, 
пока есть пользователи, которые работают с дисплеями в режиме 8 бит/пиксел, 
что приходится делать, когда объем памяти на видеокарте не превышает 1 Мб. 

Допустим, мы воспроизводим в окне одно П!В-изображение. Первое, что надо 
сделать, — создать логическую палитру (юз1са1 раеие) — сП]-объект, содержащий 
цвета из ОТВ. Затем нужно реализовать ее в аппаратную системную палитру (зубет 
раеце) — таблицу из 256 цветов, одновременно отображаемых видеокартой. Если 
программа активна (Югезгоипа), УЛп4о\/з пытается скопировать все заданные цвета 
в системную палитру, но не трогает 20 стандартных цветов, всегда присутствую- 
щих в ней. Обычно ОВ выглядит именно так, как задумано. 

А если активна (на переднем плане) другая программа, которая отображает ОТВ 
с лесным пейзажем в 236 оттенков зеленого? Наша программа по-прежнему реа- 
лизует свою палитру, но на этот раз несколько иначе. Теперь системная палитра 
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не меняется, а просто палитры — системная и наша логическая — сопоставляют- 
ся по-новому. Например, если наша программа отображает цвет розового неона, 
УПпао\$ сопоставит его стандартному красному цвету. И если вы забудете в про- 
грамме реализовать собственную палитру, при активизации другой программы весь 
розовый неон позеленеет. 

Пример с лесным пейзажем, конечно, крайность, так как в нем предполагает- 
ся, что другая программа отбирает у нас 236 цветов. Если же она реализует логи- 
ческую палитру всего лишь из 200 цветов, УЛпЧоу/5 позволит нашей программе 
загрузить 36 своих цветов, в том числе, хочется верить, и розовый неон. 

Итак, когда же программе реализовать собственную палитру? Сообщение УИп- 
Чоу’; ИМ_РАГЕТТЕСНАМСЕР направляется в основное окно вашей программы всякий 
раз, когда какая-то программа (и ваша тоже) реализует свою палитру. Другое со- 
общение, УМ_ОПЕКУМЕ\УРАГЕТТЕ, посылается, когда одно из окон программы 
получает фокус ввода. Программа должна реализовать свою палитру в ответ на 
оба этих сообщения (если только не она их отправила). Однако эти сообщения 
не передаются окну объекта «вид». Вы должны создать соответствующие обработ- 
чики в основном окне приложения и предусмотреть уведомление объекта «вид». 
Взаимосвязи окна-рамки и объекта «вид» обсуждаются в главе 14. 

Для реализации палитры вызывают \УЛп32-функцию КеайзеРжщене, но сначала 
надо вызвать 5#ес!Рщейе, чтобы подключить логическую палитру О1В-изображе- 
ния к контексту устройства. У $@есРщене есть параметр — флаг, который в обра- 
ботчиках сообщений УМ_РАГЕТТЕСНАМСЕР и УМ _ОПЕКУМЕТРАГЕТТЕ обычно ус- 
танавливается в РАГ5Е. Это гарантирует реализацию палитры как палитры пере- 
днего плана, если ваше приложение действительно активно. Установив флаг в ТКИЕ, 
вы заставите УЛпао\уз реализовать палитру так, будто приложение исполняется в 
фоновом режиме. 

Вы также должны вызывать КеайзеРжщене для каждого О!В-изображения, вос- 
производимого при работе функции Ои)тгаш. Сначала, конечно, нужно вызвать 
5аесРщейе, на этот раз с флажком ТКОЕ. Если программа показывает несколько 
Р1В-изображений, каждое со своей палитрой, задача существенно усложняется. Но 
в принципе нужно выбрать палитру для одного из Р1В-изображений и реализо- 
вать се (подключив с параметром ЕАГ5Е) в обработчиках сообщений для палит- 
ры. Это Р1В-изображение скорее всего будет выглядеть лучше других. Есть несколь- 
ко способов совмещения палитр, но куда проще пойти и купить дополнительную 
видеопамять. 


О1В-растры, пикселы и цветовые таблицы 


Р1В-растр состоит из двумерного массива элементов — пикселов (р1хер. Часто 
каждый пиксел ГВ соответствует пикселу на экране, но его можно также спрое- 
цировать и на какую-то логическую область экрана — в зависимости от режима 
преобразования координат и параметров масштабирования функции вывода изоб- 
ражения. 

Пиксел состоит из 1, 4, 8, 16, 24 или 32 последовательных битов — все опреде- 
ляется цветовым разрешением конкретного изображения. В ОТВ с разрешениями 
16, 24 и 32 бит/пиксел каждый пиксел представляет какой-то ВСВ-цвет. В ОВ с 
разрешением 16 бит/пиксел на значения красного, зеленого и голубого цветов, 
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как правило, отводится по 5 бит, а в более распространенных РВ с разрешением 
24 бит/пиксел — по 8. ОВ с разрешением 16 и 24 бит/пиксел оптимизированы для 
видеоплат, способных воспроизводить одновременно 65 536 или 16,7 миллионов 
цветов соответственно. 

О В-изображения с разрешением 1 бит/пиксел — монохромные, но’не обяза- 
тельно черно-белые. Допускаются любые 2 цвета из встроенной в ГВ цветовой 
таблицы. В цветовой таблице монохромного растрового изображения есть два 32- 
разрядных элемента, каждый из которых содержит по 8 битов на красный, зеле- 
ный и голубой, и еще 8 битов для флагов. Для пикселов со значением 0 использу- 
ется первый элемент, а со значением 1 — второй. Если ваша видеоплата воспро- 
изводит 65 536 или 16,7 миллиона цветов, \Лп4о\у; сможет напрямую отобразить 
эти два цвета. (В видеорежиме с 65 536 цветами \ИЛпао\; урезает 8-битные зна- 
чения до 5-битных.) Если видеоплата работает в режиме 256 цветов с использо- 
ванием палитры, программа сможет скорректировать системную палитру, загру- 
зив в нее нужные два цвета. 

Распространены также РВ с цветовым разрешением 8 бит/пиксел. Как и в 
монохромных Г}, у них тоже есть цветовая таблица, но с 256 (или менее) 32- 
разрядными элементами. Каждый пиксел в этой таблице — индекс. При наличии 
видеоплаты с поддержкой палитр программа может создать из этих 256 элемен- 
тов логическую палитру. Если системную палитру контролирует другая програм- 
ма, выполняемая на переднем плане, УЛп4о\5 старается наилучшим образом со- 
поставить цвета вашей логической палитры с цветами системной. 

А если попытаться воспроизвести ОВ с цветовым разрешением 24 бит/пик- 
сел на 256-цветной видеоплате с поддержкой палитр? В идеале автор ГЛВ должен 
был бы включить в нее цветовую таблицу с важнейшими цветами. В этом случае 
ваша программа может построить по этой таблице логическую палитру, и изоб- 
ражение выглядело бы нормально. Если же цветовой таблицы в ПВ нет, исполь- 
зуйте палитру, возвращаемую функцией 11352 СтешеНаЙопеРжене. В любом случае 
это лучше, чем 20 стандартных цветов, доступных при отсутствии какой бы то ни 
было палитры. Еще один вариант — проанализировать ОТВ, чтобы определить 
важнейшие цвета, но для этого можно приобрести готовую утилиту. 


Структура ОВ в ВМР-файле 


Как вы помните, ОМВ — это стандартный формат \/1 40% для растровых изобра- 
жений, и хранятся они в ВМР-файлах. Заглянем же внутрь ВМР-файла и посмот- 
рим, что там (рис. 6-2). 

Структура В/ТМАРЕЦШЕНЕАРЕК содержит смещение битов изображения, на ос- 
нове которого можно вычислить общий размер структуры В/ТМАРИМЕОНЕАРЕК и 
следующей за ней цветовой таблицы. В структуре В/ТМАРЕШЕНЕАРЕК есть поле, 
хранящее размер файла, но полагаться на него не стоит, так как вам неизвестны 
единицы измерения: байты, слова или двойные слова‘. 

„Структура ВГГМАРИУЕОНЕАРЕК определяет размеры растрового изображения, 
число битов на пиксел, информацию об упаковке изображений с 4 и 8 бит/пик- 


' Автор ошибается: согласно документации \Лп49о\из размер файла указывается 


в байтах. — Прим. перев. 
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сел, а также количество элементов в цветовой таблице. Если ПВ упакован, этот 
заголовок содержит размер массива пикселов — иначе этот размер можно вычис- 
лить по размеру растрового изображения и цветовому разрешению. За заголов- 
ком — цветовая таблица (если она вообще есть в данном ГВ). Далее размещает- 
ся собственно О1В-изображение, состоящее из пикселов, упорядоченных по стол- 
бцам в пределах строк, начиная с нижней. Каждая строка выравнивается по гра- 
нице, кратной 4 байтам. 

Единственное место, где вы встретите структуру В/ТМАРЕПЕНЕАРЕК, — ВМР- 
файл. Если ОВ получен, скажем, из буфера обмена, то заголовка файла в этой 
структуре нет. Цветовая таблица располагается за структурой В/ТМАРИМЕОНЕАРЕК, 
но изображение не всегда располагается сразу за цветовой таблицей. Поэтому, если 
вы, допустим, используете функцию СтешерИ/В$есйоп, выделяйте место для заго- 
ловка растрового изображения и цветовой таблицы, а уж где размещать изобра- 
жение, пусть решает сама УЛп4о\5. 


Буре = «ВМ» | 
БИВИЗ | 


ыисге (размер структуры) 

БИЛО (ширина в пикселах) 

ЫНед! (высота в пикселах) 

ЫР/апе$ =1 (число плоскостей) 

ЫВИСоиге (число битов: 1, 4, 8, 16, 24 или 32) 
ЫСотргеззоп (сжатие, при отсутствии сжатия — 0) 
Б/с1ге/таде (указывается только при сжатии) | 
БГС5ва (ненулевое значение для коротких цветовых таблиц) | 


ВТМАРЕЕЕНЕАОЕВ 
(только ВМР-файлы) 


ВПМАРИМЕОНЕАОЕВ 


Цветовая таблица | 2 элемента для монохромных 01В-растров 
16 или менее элементов для 0!В-растров с 4 бит/пиксел 


256 или менее элементов для О!В-растров с 8 бит/пиксел 


Размер каждого элемента — 32 бита 


В столбце пикселы располагаются по строкам | 
Строки выравниваются на 4-байтовую границу | 


Рис. 6-2. Формат ВМР-файла 


01В-изображение 


Функции для работы с ОВ 


В УЛпао\з предусмотрено несколько важных функций для работы с ОТВ. Ни для 

одной из них нет аналога в МЕС, поэтому более подробную информацию ищите 

в документации по 1132. Мы приведем лишь краткое описание данных функций. 

Ш 5ейлВи$ТоБемлсе непосредственно отображает ОТВ на экране или принтере. 
Масштабирование не осуществляется; один пиксел растрового изображения 
соответствует одному пикселу на экране или на принтере. Отсутствие масш- 
табирования снижает полезность этой функции. Механизм ее работы отличен 
от ВИВИ, в которой используются логические координаты. 

Ш $геюсЬМВИ$ непосредственно отображает Р/В на экране или принтере; ра- 
ботает аналогично $есрВИ. 
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Ш СейуВИ$ создает ППВ из СП]1-растра, используя выделенную программистом 
память. Вы можете в какой-то степени управлять форматом Г/В, так как эта функ- 
ция позволяет задавать число «цветовых» битов на пиксел и сжатие. Если при- 
меняется сжатие, Сей2/Вй5 надо вызывать дважды: сначала для вычисления нуж- 
ного объема памяти, а затем — для генерации данных ПИВ. 

Ш Сгеше[Витар создает СП!-растр из 21. Как и все подобные О!В-функции, 
требует передачи указателя на контекст устройства в качестве параметра. Можно 
указывать контекст дисплея; использовать контекст устройства в памяти не 
обязательно. 

Ш Стеше[МВ$есйоп создает особую разновидность РВ — Р/В-секцию (РТВ зесйоп) 
и возвращает описатель СОГ-растра. Эта функция сочетает в себе лучшие сред- 
ства работы с ППВ и растровыми изображениями СПТ. Вы получаете прямой 
доступ к памяти ОТВ и, имея описатель растрового изображения и контекст 
устройства в памяти, можете вызывать СО!-функции для рисования в ОВ. 


Класс СО 


Не пугайтесь сложностей работы с ОВ — класс СГ упростит ее. Чтобы позна- 
комиться с ним, лучше всего изучить его открытые члены — функции и перемен- 
ные. Ниже показан заголовочный файл класса СО». Код реализации вы найдете в 
папке ЕхОбА на компакт-диске. 


см. след. стр. 


5—2064 
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Далее кратко описаны функции-члены СО1р, начиная с конструкторов и дест- 
руктора. 

Ш Конструктор по умолчанию применяется, если предполагается загружать ГВ 
из файла или подсоединять экземпляр класса к уже существующему в памяти 
ОТВ. Конструктор по умолчанию создает пустой О1В-объект. 

Ш Конструктор О1В-секции применяется, если нужна О!В-секция, создаваемая 
при использовании Стешер]В$есйоп. Его параметры определяют размер и 
количество цветов в ОТВ. Конструктор выделяет память для хранения заголов- 
ка, но не для хранения изображения. Этот конструктор также можно приме- 
нять для самостоятельного выделения памяти для изображения. 


ГЛАВА 6 Классические СО!-функции, шрифты и растры 103 


Параметр Описание 
512е Объект С5$#е, задающий ширину и высоту ПВ 
пВИСоит Число бит/пиксел. Допустимые значения: 1, 4, 8, 16, 24 или 32 


Деструктор освобождает всю выделенную для ПВ память. 

АнасЬМарЕЙе открывает проецируемый в память файл в режиме чтения и 
подсоединяет его к объекту СБ. Функция сразу возвращает управление, так 
как не считывает файл в память, пока тот не потребуется. Но при доступе к [В 
могут возникать задержки, связанные с подкачкой файла в память. Функция 
освобождает выделенную ранее память и, если надо, закрывает присоединен- 
ный ранее проецируемый файл. 


Параметр Описание 

5пРарпате Полное имя (с путем) проецируемого файла 

брате Флаг, значение которого равно ТКИЕ, если файл надо от- 
крыть в режиме совместного использования; по умолча- 
нию — 24[5Е 


Возвращаемое значение ТКИОЕ — при благополучном завершении 


АнасЬМетогу связывает существующий объект СР: с ОТВ в памяти. Эта па- 
мять может быть ресурсом программы или находиться в буфере обмена или в 
объекте данных ОГЕ. Ее можно выделить оператором пеи? или функцией С/юБа/- 


Параметр Описание 

роМет Адрес присоединяемой памяти 

ЬМияраее Флаг, значение которого равно ТКОЕ, если за освобожде- 
ние памяти отвечает объект СР; по умолчанию — Е4[5Е 

[912171 Если память получена вызовом функции \/т32 СтобАЙос, 


объект СО должен запомнить описатель области памяти, 
чтобы впоследствии освободить ее (при ВМиеме, рав- 
ном ТКОЕ) 


Возвращаемое значение ТКИЕ — при благополучном завершении 


Сотрге$$ восстанавливает О1В в сжатом или развернутом виде, т. е. преобра- 
зует существующее Р1В-изображение в СП]1-растр, после чего повторно созда- 
ет сжатое или развернутое О!В-изображение. Сжатие поддерживается только 
для О1В с цветовым разрешением 4 или 8 бит/пиксел. ОВ-секцию сжать нельзя. 


Параметр Описание 
рос Указатель на контекст дисплея 
ВСотрге55 ТКОЕ (по умолчанию) означает сжатие РТВ, а ЕА[5Е — 


развертывание 
Возвращаемое значение ТКИЕ — при благополучном завершении 


СоруТоМарейе создает новый проецируемый в память файл и копирует в него 
данные из существующего Р'В. При этом освобождается вся выделенная ранее 
память, и закрывается прежний проецируемый файл (если таковой был). Дан- 
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ть найк Зла деды зо ннйн, бити о ними бы ор НИИ 


ные не записываются на диск, пока новый файл не закрывается, что происхо- 
дит при повторном использовании или уничтожении объекта СР. 


О еааоаааненичанивания 


Параметр Описание 
5пРарпате Полное имя проецируемого файла 


Возвращаемое значение ТКОЕ — при благополучном завершении 
а аа, Аа В. 


Ш СтешеВитар создает из существующего О1В-изображения СП]1-растр. Вызы- 
вается функцией Сотрте55. Не путайте эту функцию с Стеше$есйоп, которая 
создает Р1В и запоминает описатель. 


ААА АА ААА ААА и 


Параметр Описание 
рос Указатель на контекст дисплея или принтера 


Возвращаемое значение Описатель растрового изображения СП (при неудаче — 


МОП); не записывается в открытую переменную-член 
ПИВНЫЕ НЫНЕ р Ч БН ВЕ ВОВИИ 


Ш Сгеше$есноп создает П!В-секцию, вызывая функцию \/1п52 Стеше[/В$есноп. 
Память, выделенная под изображение, не инициализируется. 


них 


Параметр Описание 
РОС Указатель на контекст дисплея или принтера 


Возвращаемое значение Описатель СП!-растра (при неудаче — МОГ); также запи- 


сывается в открытую переменную-член 
аа ОЕ ВОИС НА ЕС НИ АННИНО САН 


Ш _ Огаи выводит объект СОА на дисплей (или принтер), вызывая функцию УЛп32 
УтесрОВй5. При необходимости растровое изображение растягивается для 


подгонки под заданный прямоугольник. 


ЗАЗ ое ааа 
Параметр Описание 


РОС Указатель на контекст дисплея или принтера — получатель 
ОВ-изображения 

Опот Объект СРой\4, содержащий логические координаты, в ко- 
торые выводится ПВ 

512е Объект С5#е, в логических единицах задающий размеры 
прямоугольника на устройстве вывода 


Возвращаемое значение ТКИЕ — при благополучном завершении 
ЕЕ ра а Ноно боано А льивьсьыВЙ 1 „роза 


Ш Етрёу очищает ОТВ, освобождая при необходимости выделенную память и 
закрывая спроецированный в память файл. 


Ш Сешйпеп$юи5 возвращает ширину и высоту ГВ в пикселах. 
аа 


Параметр Описание 


Возвращаемое значение Объект С5е 
ры оо аш 


Ш Се1512еНеааег возвращает общее число байт в информационном заголовке и 
цветовой таблице. 


Параметр Описание 
Возвращаемое значение 32-разрядное целое 
а РЕ МЫ Ле Па ПА 
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бе154зе]таве возвращает размер изображения Г1В в байтах (исключая инфор- 


мационный заголовок и цветовую таблицу). 


я 
Параметр Описание 


Возвращаемое значение 32-разрядное целое 


МавеРщейе считывает цветовую таблицу и, если эта таблица существует, со- 


здает палитру УЛп4о\5. Описатель НРАГЕТТЕ запоминается в переменной-члене. 


ААА ИИА ААА ААА ААА ААА 
Параметр Описание 


Возвращаемое значение ТКИЕ — при благополучном завершении 


Кеа4 считывает ОВ из файла в объект СО.. Файл должен быть предваритель- 
но успешно открыт. Если файл в формате ВМР чтение осуществляется с нача- 
ла файла. Если же файл представляет собой документ, чтение начинается с 
текущей позиции указателя файла. 


я 
Параметр Описание 


РЕЙе Указатель на объект СЁйе; соответствующий файл на диске 
содержит ПВ 


Возвращаемое значение ТКИЕ — при благополучном завершении 


Кеа$есноп считывает заголовок из ВМР-файла, вызывает СуешеГИВ$есноп для 
выделения памяти, а затем считывает в эту память изображение из файла. Эта 
функция полезна, если нужно считать О!В-изображение с диска и отредакти- 
ровать его вызовами СОТ. Отредактированное изображение можно записать на 


диск, используя функции йе или Сору1оМарЕйе. 


ИЯ 
Параметр Описание 


РЕЙе Указатель на объект СЁЕйе; соответствующий файл на диске 
содержит РВ 


РОС Указатель на контекст устройства дисплея или принтера 
Возвращаемое значение ТКОЕ — при благополучном завершении 


$епайЙхе выполняет сериализацию (см. главу 16). Функция СО::5еайзе, пе- 
реопределяющая МЕС-функцию СОБес!:$епайзе, вызывает функции-члены КеаЯ 
и ще. Параметры описаны в М&го5ой Еоипааноп Са лЬгагу Ке/егепсе. 

5$е5уяетРщейе вызывается для П1В-изображения с цветовым разрешением 
16, 24 или 32 бит/пиксел, у которого нет цветовой таблицы, чтобы создать для 
объекта СР логическую палитру, соответствующую палитре, возвращаемой 
функцией СтешеНаЙопеРщене. Если ваша программа работает с 256-цветным 
дисплеем, поддерживающим палитры, и вы не вызываете бе узетРещейе, то при 
выводе ОВ используются только 20 стандартных цветов Х/п4оу%!з (так как па- 


литра не задана). 


ани 
Параметр Описание 


РОС Указатель на контекст дисплея 
Возвращаемое значение ТКИЕ — при благополучном завершении 
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Ш ОбеРщейе подключает логическую палитру объекта СР к контексту устрой- 
ства и реализует ее. Функция-член Ога вызывает ИзеРщейе перед рисовани- 
ем ОВ. 


Параметр Описание 

рос Указатель на контекст устройства дисплея (для реализации 
палитры). 

БВасЕвтоипа Если этот флаг равен Е4/5Е (по умолчанию) и приложение 


выполняется на переднем плане, УЛп4о\$ реализует эту 
палитру как палитру переднего плана (копирует в систем- 
ную палитру максимально возможное число цветов). 

В противном случае (ТКОЕ) \Лп9о\$ реализует палитру 
как фоновую (стремясь наилучшим образом отобразить 
логическую палитру на системную). 


Возвращаемое значение Число элементов логической палитры, отображенных на 


системную палитру. В случае ошибки возвращается значе- 
ние СО ЕККОК. 


Ш уе записывает ПВ из объекта СО в файл. Файл должен быть предварительно 
успешно открыт или создан. 


Параметр Описание 


РЕЦе Указатель на объект СЁЕйе; ГВ записывается в соответству- 
ющий дисковый файл 


Возвращаемое значение ТКОЕ — при благополучном завершении 


Для удобства четыре открытых переменных-члена обеспечивают доступ к па- 
мяти ОТВ и кописателю О!В-секции. Эти переменные дают ключ к структуре объекта 
СР. Он представляет собой набор указателей на память в куче. Владельцем этой 
памяти может быть и ОВ. Дополнительные закрытые переменные-члены опре- 
деляют, должен ли класс СО освобождать память. 


Производительность при выводе П!В-изображения на дисплей 


Оптимизированная обработка РВ — одна из главных особенностей УЛп4о\5. 
У современных видеокарт есть специальные буферы, поддерживающие стандар- 
тный формат О!В-изображений. Если программа выполняется на компьютере с 
такой платой, она может задействовать преимущества нового Р/В-процессора (РТВ 
епрше) УЛп4о\з, который ускоряет процесс прямого рисования изображений из 
ОТВ. Если же программа выполняется в режиме УСА, вам не повезло: она будет ра- 
ботать медленнее, хотя и вполне корректно. 

При работе с \Ип4о\уз в режиме 256 цветов изображения 8 бит/пиксел будут 
выводиться на дисплей очень быстро как при помощи $тесрВИ, так и Утес Г/Вй5. 
Но при выводе растровых изображений 16 или 24 бит/пиксел эти функции ра- 
ботают слишком медленно. Добиться ускорения вывода можно, создав отдельный 
СОГ-растр с 8 бит/пиксел с последующим вызовом 5#есрВИ. Конечно, при этом 
надо реализовать корректную палитру перед созданием изображения и выводом 
его на экран. 

Следующий фрагмент кода можно вставить сразу после загрузки объекта СБ 
из ВМР-файла: 
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// т_ПВ11тар - переменная-член типа НВТТМАР 

// м_ЧсМем - объект контекста устройства в памяти класса С0С 
т_р016->УзеРа1етте($4с); 

т_ИВ1тар =. м_р016->СгеафеВ1{тар(&ас); // может работать медленно 
: : 5е1ест06] ест (м_асМет. бетбаРенНас(), т_ИВ1{тар): 


А этот код можно использовать вместо СРФ::Отгаш в функции ОпОга класса 
«ВИД»: 


п_р016->зеРа1етте(&4с); // можно поместить в обработчик сообщения палитры 
($17е $17е016 = м_р016->@е101теп$10п$(); 
р0С->5{гетсвв1{(0, 0, $17е016.сх, $12е016.су, &т_@сМем, 

0, 0, $5127еТоОгам.сх, 312еТо0гам.су, УАССОРУ); 


Не забудьте вызвать реееОвБес! для т_РВитар, когда закончите работу с ним. 


Пример Ех0ба 


Теперь посмотрим, как СРФ-класс работает в приложении. ЕхОба воспроизводит 
два О!В-изображения: одно из ресурса, а другое из ВМР-файла. Программа управ- 
ляет системной палитрой и корректно выводит ОВ на принтер. 

Давайте обсудим процесс создания программы ЕхОба. Неплохо было бы вруч- 
ную ввести код класса «вид», но лучше взять готовые файлы с(И.В и сЧ1Ъ.срр с ком- 
пакт-диска. 

1. С помощью МЕС АррИсаНоп У/1таг@ создайте проект Ех064. Примите 
параметры, предлагаемые по умолчанию, но выберите ше Босштепи и ба- 
зовый класс СустоИеи; для класса СЕхОба\еи.. 

2. Импортируйте растровое изображение Кей ВосЕ$. В меню Рго}]есЕ выбе- 
рите команду АЧА Везоигсе. В диалогом окне Ааа Везоигсе щелкните кнопку 
Пирог. Импортируйте растровое изображение Веа В!оск$.61тр из каталога 
\усррпе\Ытарз на компакт-диске. У15ца1 С++ .МЕТ скопирует этот файл в 
подкаталог \гез вашего проекта. Назначьте изображению идентификатор ПОВ _КЕР- 
ВГОСК$ и сохраните внесенные изменения. 

5. Добавьте в проект класс СО. Если проект создавался с нуля, скопируйте 
файлы с1Ь.В и сЯ.срр из каталога \усррпе\ехОба на компакт-диске. Но про- 
стого копирования недостаточно — нужно добавить эти файлы в проект: вы- 
берите команду Ааа Ех15Ип$ Цет из меню Рго]еси среды разработки, а затем в 
списке выберите файлы с1Ь.В и с 1Ъ.срр и щелкните кнопку ОК. Теперь в окне 
С]а$$Ме\ или бошНоп Ехр!огег вы увидите класс СП со всеми его членами — 
переменными и функциями. 

4. Добавьте закрытые переменные-члены типа СО» в класс СЕхОбаЙеи.. 
В конце заголовочного файла СЕхОба\1еу»В вставьте строки: 


рг1\ате: 
(016 т_916711е; 
(016 т_916Везоигсе; 


А в начало файла ЕхОба\1е\/ п: 


Нпс1иае “са16. п” 
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5. Отредактируйте функцию ОптийиЮраеие в файле Ехоб4\1еуусрр. Эта 
функция устанавливает режим преобразования координат в ММ_НЫМЕТЕГС и 
загружает объект 7и_ИРКезоитсе из ресурса ШВ_ЮЕРВГОСКУ. Объект к ресурсу 
в ЕХЕ-файле подсоединяет функция СБ ::АНасЬМетоту. Введите выделенный 
КОД: 


\019 Сехоба\1ем: :ОпТп111а10рдае() 

{ 
С$сго11\1ем: :ОпТп1{1а10рааее(); 
С$12е 101а1512е(30000, 40000); // 30х40 см 
С$12е 11пе512е = 6$312е(+01а1$12е.сх / 100, 101а1512е.су / 100); 
$е15сго11$12ез(ММ_НТМЕТАТС, +01а1512е, 101а1512е, 11пе$12те); 
ЕРУОТО 1руВезоигсе = (ЕРУОТО) : : [оадВезоигсе( МЫ, 

:; АпаВезоигсе( МИ, МАКЕТМТВЕЗОУВСЕ( ТОВ_ВЕОВЕОСК$), АТ_ВТТМАР)); 
п_916Везоигсе. АетаспМетогу(1руВезоигсе); —// ::ЕоскВезоигсе не требуется 
СС11еп0С 9с(+11$); 

ТВАСЕ( "611$ рег р1хе1 = Х4\п", дс. бе0еу1сеСарз( ВТТЗРТХЕЕ)): 
} 


6. Отредактируйте функцию-член ОнОгаи в файле Ехоба\У1еу.срр. В коде 
этой функции вызывается СО1р;:Огаш для каждого из двух ОТВ. ИзеРщейе дол- 
жны вызывать на самом деле обработчики сообщений ИМ ОПЕКУМЕУРАГЕТТЕ 
и ИМ_РАГЕТТЕСНАМСЕО. С этими сообщениями работать довольно трудно, так 
как их не посылают непосредственно объекту «вид», поэтому мы прибегнем к 
упрощению. Добавьте выделенный код: 


\014 СЕхОба\1ем: :Опбгам(С0б* р0С) 
{ 


Вед1пМа1ЕСигзог(); 
п_916Незоигсе. /зеРа1е{{е(р0С); —// это должно быть не здесь, 
т_916711е. /зеРа1етте(р0С); // а в обработчиках сообщений палитры 


рОС->Тех{0и*(0, 0, “Ргезз Не 1еР+ тоизе БиЁтоп Неге +о 10а4 а 111е.”); 
С$12е 312еВезоигсе016 = м_916Везоигсе. бе=01тепз1опз( ); 
312еВезоигсе01Ь.сх += 30; 
3$12еВезоигсе016.су *= -30; 
п_916Незоигсе. Огам(роС, СРо1п{(0, -800), 317еВезоигсеб1ь); 
С$12е $12е[711е016 = м_916711е. 6е+01тепз10пз(); 
$12е[11е016.сх *= 30; 
$12е711е016.су *= -30; 
м_916211е.Огам(рОС, СРо1п+(1800, -800), $12еЕ11е01ь); 
ЕпдМа1Сигзог(); 

} 


7. Создайте в классе СЕхоб4Йеи обработчик сообщения УМ ТВОТТОМ- 
РОУМ. Отредактируйте файл ЕхОба\1ехусрр. ОтВийопроит содержит код для 
считывания РВ двумя способами. Если вы оставите определение МЕМОКУ МАР- 
РЕР_ЕШ.Е$, активизируется код, использующий АйасьМарЕйе для считывания 
проецируемого в память файла. Если же вы закомментируете первую строку, 
активизируется вызов Кеай. Вызов 5е5уетРеиейе присутствует здесь специ- 
ально для О\В, у которых нет цветовой таблицы. Введите выделенный КОД: 
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#9ег1пе МЕМОНУ_МАРРЕО_ЕТЕЗ 
\014 СЕх1Ос\1ем: : Оп-Ви{фопбомп (УТМТ пЕ1адз, СРо1пф ро1пт) 
{ 
СЕ11е01а109 919(ТВУЕ, “Бтр”, “*.Бтр”) 
11 (919.00Мода1() != ТООК) { 
гетигп; 
} 
#1Г9ет МЕМОВУ_МАРРЕО_ЕТЕЗ 
1 (м_ 9157. АфасйМарЕ11е( 919. бетРа{ПМате( ), 
ТВУЕ) == ТВУЕ) { // совместное использование 
Тпуа11дате(); 
} 
#е15е 
СЕ11е 111е; 
11е. 0реп( 919. бетРа{АМате(), СЕ11е: : подевеад); 
11 (м_916711е. Веа9(&111е) == ТВИЕ) { 
Тпуа11дате(); 


} 
#еп491{т // МЕМОВУ_МАРРЕО_РЕТЬЕ$ 
СС11еп{0С 9с(11013); 
т_915711е. Зе узфетРа1етте( &4с); 
} 


8. Соберите и запустите приложение. В каталоге проекта ЕхОба на компакт- 
диске есть несколько интересных растровых изображений. Файл сШсазо.Бтр — 
это РВ с 8 бит/пиксел и цветовой таблицей с 256 элементами; югезеБтр и 
с1ои45$.Бтр тоже имеют цветовое разрешение 8 бит/пиксел, но их цветовые 
таблицы меньше; ра!ооп$.Ьтр — это ОТВ с 24 бит/пиксел без цветовой табли- 
цы. Попробуйте и другие ВМР-файлы, если они у вас есть. Кстати, Веа В!оск$ — 
это 16-цветное ГШВ-изображение, в котором используются стандартные цве- 
та, всегда имеющиеся в системной палитре. 


Еще несколько слов о ПВ 


Каждая новая версия УЛпо\ предлагает новые возможности программирования 
РВ. УЛп9о\$ 2000 поддерживает функции Гояйтаве и ОгашГАЬОтгаш, альгерна- 
тивные уже описанным нами О!В-функциям. Поэкспериментируйте с этими фун- 
кциями и посмотрите, как они работают в ваших приложениях. 


Функция [оа!таде 


Функция Гоа таве может считывать растровое изображение прямо из дисково- 
го файла, возвращая описатель О!В-секции. Допустим, нам нужно добавить функ- 
цию-член к классу СО, которая действовала бы, как Кеаа$есйоп. Вот какой код 
можно добавить в СА1Б.срр: 


ВОО С016: :Тмадегоа9(сопз{ спаг»х 1р$2РатПМате, СОС» роб) 
{ 
Етрту(); 
п_пВ1тар = (НВТТМАР) ::ГоадТтаде(МЕ, 1р$7РафПМате, ТМАбЕ_ВТТМАР, 0, 0, 
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ЕА_ГОАОРВОМЕТЕЕ | ЕВ_СВЕАТЕОТВЗЕСТТОМ | 18В_ОЕРАУЕТЗТ7Е): 

ОТВЗЕСТТОМ 93; 

\УЕНАТРУ( : : бе06]ес(м_ИВ14тар, $12е01(4$), &93) == $17е01(4$)) 

// Выделить память для ВТТМАРТМЕОНЕАОЕВ 

// и наибольшей возможной таблицы цветов 

п_1рВМТН = (ЕРВТТМАРТМЕОНЕАОЕВ) пем спаг[$17е01 (ВТТМАРТМЕОНЕАВЕВ) + 
256 * $127еот(ВСВОЦАО)]; 

тетсру(т_1рВМТН, &93.азВи1!, 3127е0+(ВТТМАРТМЕОНЕАОЕВ)); 

ТВАСЕ( ”СО1Ь: :оадТтаде, 61С1г0зед = %4, 1С1гТтрогеапе = %а\п" 
п_1рВМТН->61С1г0зе4, м_1рВМТН->61С1 "Ттрогфапе) 

СотрифеМе{г1с$(); // устанавливает т_1руСо1огТаб1е 

т_пВм1НА110С = сг{А]110С; 

т_1рТтаде = (ЕРВУТЕ) 43$. 4$Вт. 6м8В11$: 

т_пГмадед110с = поА110с; 

// Получить таблицу цветов ОТВ секции 

// и создать из нее палитру 

С0С тетас; 

тетас. СгеафеСотра*161е0С(р0С); 

: : Зе1естОБ]ес{ (тетас. бетбатенас(), т_пВ1\тар); 

ОТМТ пСо10гз = : : бетОТВСо1огТаБ1е(метас. ветбатенас(), 0, 256, 
(ВОВОЦА»*) м_1руСо1огТабе); 

ТР (пС010гз != 0) { 
СотритеРа1е+е$12е(т_1рВМТН->61В1+Соип+): 
МакеРа1етте(); 


} 

// контекст устройства в памяти уничтожается, 
// растровое изображение отключается 

гефигп ТВОЕ; 


Эта функция извлекает и копирует структуру ВИИМАРИУЕОНЕАРЕК и устанавли- 
вает значения указателей-членов класса СО. Чтобы извлечь палитру из П1В-сек- 
ции, нужно потрудиться, но \/1132-функция СейЙВСоютТаЫе послужит в этом 
хорошим подспорьем. Интересно, что СеЙ/ВСою7ТаЫе не может сообщить, сколько 
элементов палитры использует данное Р!В-изображение. Если, к примеру, в ГВ 
применяются только 60 элементов, СейлВСоют"ТаЫе строит цветовую таблицу из 
256 элементов со 196 элементами, установленными в 0. 


Функция Огаи/ОЬОгаи 


УЛпао%з включает компонент \У14ео ог \/пао\$ (УЕХ/, поддерживаемый У15иа1 
С++ .МЕТ. УЕ\-функция РгашОтгаи — альтернатива функции ${"есЬО/Ви5. Одно 
из преимуществ ВташО®Бтаи — возможность использовать смешанные (АпБегеа) 
цвета, другое преимущество — ускоренное рисование изображений с числом би- 
тов на пиксел, не совпадающим с текущим видеорежимом. Основной же недоста- 
ток — необходимость подключать код УЕ\/ к прикладному процессу во время ис- 
полнения. 

Ниже приведена функция Руа класса СР, которая вызывает ОхашООгаш: 
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ВООЕ С01Ь: :Огам016(С0С* рОС, СРо1п{ ог191п, 05176 $17е) 
{ 
1# (м ПРВМТН == МЕ) гефигп РАЕЗЕ; 
11 (м _ПРа1ефте != МУ) {4 
: :бе1есфРра1е{е(рОоС->бетЗатенас(), м_пРа1ее, ТВуЕ); 
} 


НОВАМОТВ Па9 = ::Огам0160реп(); 
СВесф гест(ог191п, $176); 
роС->ЕРТо0Р( гес\); // Преобразуем координаты прямоугольника 


// 01В-изображения в режим ММ_ТЕХТ 
гесф -= р0б->бет\1емрог{0гоа(); 
1п пМарМоде019 = р0б->5ет{МарМоче (ММ_ТЕХТ); 
: :Огам0160гам(н99, роС->бетЗатенас(), гесф.1етф, гес*. фор, 
гес+.\1а+н(), гесф.Незопт(), т 1рВМТН, м_1рТтаде, 0, 0, 
т 1рВМТН->ЬЗ\таей, м _1рВМТН->61Незойт, 0); 
роС->3е{МарМоде ( пМарМоде014); 
\ЕВТЕУ( : : Огам016С10зе(п9а)); 
гефигп ТВИЕ; 


ДгашЬОгаш требует координат ММ_ТЕХТ и режима преобразования коорди- 
нат ММ_ТЕХТ. Таким образом, логические координаты следует преобразовать не 
в координаты устройства, а в пикселы — с начальной точкой в левом верхнем углу. 

Чтобы использовать РгашО®Оташ, в программу надо включить оператор 
нтсшае <иоЬ>, а также подключить библиотеку уБ\32.1Ь в список входных фай- 
лов загрузчика. РуашГОгаш полагает, что выводимое ею изображение распола- 
гается в памяти с доступом для чтения и записи, — помните об этом, выделяя память 
под ВМР-файл. 


Растровые изображения на командных кнопках 


Библиотека МЕС облегчает вывод на командных кнопках растровых изображений 
вместо текста. При программировании с нуля следовало бы установить для кноп- 
ки стиль О\’пег Ога\ и написать обработчик сообщения в классе диалогового окна, 
который рисовал бы растровое изображение в окне элемента управления «кноп- 
ка». А при использовании МЕС-класса СВйтарВийоп задача заметно упрощается, 
хотя надо придерживаться строго определенной процедуры. Не очень переживайте 
насчет того, как все это работает, а радуйтесь, что не придется писать много кода. 

Короче, вы создаете, как обычно, диалоговый ресурс, закрепляя за кнопками, 
которые будут отображать растровые изображения, уникальные текстовые заго- 
ловки. Затем добавляете к проекту несколько ресурсов растровых изображений, 
но идентифицируете их по именам, а не числовым идентификаторам. Наконец, 
дополняете класс диалогового окна несколькими переменными-членами типа 
СВитарВийоп и вызываете для каждого из них функцию-член АмюГоаа, которая 
сопоставляет имя растрового изображения и текст кнопки. Если текст на кноп- 
ке — «СОРУ», вы добавляете два растра: «СОРУЦ» (кнопка отжата) и «СОРУГ» (кнопка 
нажата). Да, кстати, не забудьте установить стиль кнопок О\мупег Огау’. Все станет 
понятнее, когда вы сами напишете программу. 
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ААА иилиаинания 


Примечание Взглянув на код МЕС для класса сВитарВиНоп, можно заметить, 
что это растровое изображение — обычный СП]1-растр, отображаемый 
с помощью ВИВИ. Поэтому палитра здесь не поддерживается. Но обыч- 
но это не проблема, так как растровые изображения для кнопок чаще 
всего 16-цветные; в них используются стандартные цвета УСА. 


Пример Ех0бе 


Этот пример демонстрирует вывод растровых изображений на командных кнопках. 

1. С помощью МЕС АррИсайоп \/1хаг4 создайте проект Ех0бе. На странице 
АррИсаноп Туре мастера установите переключатель в положение ушае аосштепь, 
а на странице Адуапсе4 Ееагигез сбросьте флажок РипИпе апа рип ргемеуу. 

2. Модифицируйте диалоговый ресурс ТОО_АВООТВОХ в окне Везопгсе 
У1еуу. Чтобы не создавать новое диалоговое окно из-за одних кнопок, возьмем 
диалоговое окно АБоцЕ, которое МЕС АррИсаНоп УЙлагА автоматически гене- 
рирует для каждого проекта. Добавьте три командные кнопки (см. рисунок) с 
указанными названиями, оставив идентификаторы кнопок по умолчанию: 
Рс_ВИТГОМ1, 12С_ВИТТОМ2 и ШРС_ВОТТОМЗ. Размеры кнопок значения не 
имеют — в период выполнения программы МЕС подгоняет их под размеры 
растровых изображений. 


Установите в ТВОЕ свойство Ошмег Огаш всех трех кнопок. 

3. Импортируйте три растровых изображения (ЕайСору.Ь тр, ЕЧИРа$.6тр 
и Е4ЙСие.Б тр) из подкаталога \усррпе \Ех0бе на компакт-диске. В меню 
Рго}есг выберите команду Аа Везоигсе и в открывшемся окне щелкните кноп- 
ку ипроге. Начните с ЕайСору.Ьтр. Назначьте ей имя «СОРУЦ». 

Обязательно заключите имя в кавычки, чтобы идентифицировать ресурс 
по имени, а не по номеру. Теперь у нас есть растровое изображение для кноп- | 
ки в «отжатом» состоянии. Закройте окно растрового изображения и скопи- 
руйте из окна Везоигсе УЧеуу растровое изображение через буфер обмена или 
перетащите его. Переименуйте копию в «СОРУР» (кнопка в «нажатом» состо- 
янии) и отредактируйте ее. Выберите из меню Ппазе команду шуегЕ Со|ог5. 
Создать изображение отжатой кнопки можно и иначе, но инверсия — самый 
быстрый способ. 

Повторите эти операции для растровых изображений ЕаиСш и ЕайРав. 
В результате вы должны получить в своем проекте такие ресурсы: 
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Имя ресурса Исходный файл Инвертированные цвета 


«СОРУЦ» ЕЧИСоруБтр Нет 
«СОРУГ» ЕайСору.Бтар Да 
«СОТО» ЕайСие тар Нет 
«СОТ» ЕАаиСиеБтр Да 
«РАЗТЕО» ЕаИРазеБтр Нет 
«РАЗТЕО» ЕаИРазБтр Да 


Отредактируйте код класса САБОИИХ №. И объявление, и реализацию этого 
класса содержит файл ЕхОбе.срр. Для начала добавьте в объявление класса три 
закрытых переменных-члена: 


рг1уате: 
СВ1ттарВи{топ м_е91{Сору; 
СВ1тарВи оп пм_е91Си*; 
СВ1{тарВифоп м_е91{Разте; 


С помощью мастера окна Ргорегиез утилиты С1а5$ У1еуу переопределите вир- 
туальную функцию Ой/ий ов. (Убедитесь, что при этом выбран класс САвбои1- 
О.) Код обработчика сообщения выглядит так: 


ВОО САбоит019: :ОпТп1101а109() 

{ 
(С01а109: :0п1п1101а109(); 
\УЕВТЕУ(т_е91{Сору. АифоЁоа9 ( ТОС_ВИТТОМ1, +1113)); 
\УЕВТРУ(т_е91{Си+. Аифто1оа9( ТОС_ВУТТОМ2, 1113)); 
\УЕВТЕУ(п_е91{Разте. Аитогоа9(Т0С_ВИТТОМЗ, 1113)); 
гефигп ТВУЕ; // гефигп ТВУЕ ип1е$$ уои зе{ 1пе Тосиз 10 а соп{фго1, 
// ЕХСЕРТТОМ: ОСХ Ргорегфу Радез зпои19 гефигп РАЕЗЕ 


Функция АшоГоаа устанавливает связь между кнопкой и двумя соответству- 
ющими ресурсами. УЕЮЕУ — это диагностический МЕС-макрос, выводящий 
информационное окно, если имена растровых изображений заданы неверно. 
Отредактируйте функцию Оп)гаи в файле Ех0бе\У1е\.срр. Замените код, 
созданный МЕС АррИсаНЧоп УЛлгага, следующей строкой (не забудьте раском- 
ментировать определение переменной рос): 


р0С->Тех+0и1(0, 0, “Споозе Абоицф Ргот 1пе Не1р тепи. "); 
Соберите и запустите приложение. После запуска программы выберите из 


меню Нер команду АБош и понаблюдайте за поведением кнопок. На рисунке 
кнопка СОТ изображена в «нажатом» состоянии. 


АБоцеенобе 
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Кнопки с растровыми изображениями, как и обычные кнопки, отправляют 
уведомляющие сообщения ВМ _СИСКЕР. Естественно, мастера С!а5$ У1е\ позво- 
ляют создать в классе диалогового окна обработчики этих сообщений. 


Иеще пара слов о растровых изображениях на кнопках 


Мы использовали растровые изображения для отображения «нажатых» и «отжа- 
тых» кнопок. Класс СВйтарВийоп поддерживает, кроме того, растровые изобра- 
жения для кнопок, имеющих фокус ввода, и для кнопок в отключенном (@за еа) 
состоянии. Для кнопки Сору имя растрового изображения в фокусе было бы 
«СОРУЕР», а имя «вне фокуса» — «СОРУХ». Чтобы протестировать работу отключен- 
ной кнопки, создайте растровое изображение «СОРУХ», например, перечеркну- 
тое красной линией, и вставьте в программу строку: 


т_е91{Сору. Епаб1е\1пдом( ЕАЕЗЕ); 


ГЛАВА 


Диалоговые окна 


Пзиневви все \/ш4о\/-программы взаимодействуют с пользователем через 
диалоговые окна. Диалоговое окно может просто содержать сообщение и кнопку 
ОК, а может быть и очень сложной формой для ввода данных. Диалоговое окно 
можно перемещать и закрывать; оно принимает сообщения и даже отрабатывает 
команды отрисовки данных в своей клиентской области. 

Существует два типа диалоговых окон: модальные (тоЧа!) и немодальные (то@е- 
1е55). В этой главе мы познакомимся с обоими. Мы также поговорим о стандарт- 
ных диалоговых окнах УЛп4о\, предназначенных для открытия файлов, выбора 
шрифтов и пр. 


Модальные и немодальные диалоговые окна 


Базовый класс СБёюз поддерживает как модальные, так и немодальные диалого- 
вые окна. Пока открыто модальное диалоговое окно (например, Ореп ЕЦе — «От- 
крытие файла»), пользователю недоступны другие окна программы (точнее, окна 
того же потока пользовательского интерфейса). А немодальное диалоговое окно 
позволяет работать с другими окнами программы. Пример — диалоговое окно Е 
апа Вер!асе редактора Мсгозой \юг4, которое совершенно не мешает редакти- 
ровать текст. 

Выбор конкретного типа диалогового окна определяется характером создава- 
емого приложения. Программировать модальные диалоговые окна намного про- 
ще, и это часто влияет на решение программиста. 


Ресурсы и элементы управления 


Итак, диалоговое окно — это настоящее, полноценное окно. Но чем же оно отли- 
чается от окон класса СИеи», с которыми вы успели поработать? Хотя бы тем, что 
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диалоговое окно почти всегда связано с каким-нибудь ресурсом УАт4о\, иден- 
тифицирующим элементы и определяющим структуру окна. Поскольку диалого- 
вый ресурс можно создавать и модифицировать в редакторе диалоговых окон 
(одном из редакторов ресурсов), диалоговые окна формируются быстро, эффек- 
тивно и наглядно. 

Диалоговое окно содержит набор элементов управления (сопго!$): поля вво- 
да (сай согиго]; их еще называют текстовыми окнами — {ех Бох), кнопки (Бикоп), 
списки (Из5 Бох), поля со списками (сотБо Бох), статический текст (айс тех) 
или метки (1аБе[5), древовидные списки (ее \1е\э), индикаторы хода процесса 
(рговге$$ шп сагог$), ползунки (5Н4егз) и др. \ИЛпао\ управляет этими элемента- 
ми, используя специальную, значительно упрощающую труд программиста логи- 
ку группировки и обхода. На элементы управления ссылаются по указателю на Са 
(так как элементы сами являются окнами) либо по индексу (с сопоставленной сред- 
ствами #4е/те константой) назначенному в ресурсе. В ответ на действия пользо- 
вателя, скажем, ввод текста или щелчок кнопки, элементы управления передают 
сообщения родительскому диалоговому окну. 

Тесное взаимодействие библиотеки МЕС и Мисгозой \15иа! Знаю заметно об- 
легчает программирование диалоговых окон УЛпао\уз. У15иа! 5 ю генерирует 
класс, производный от Сов, а затем позволяет сопоставить переменные-чле- 
ны класса «диалоговое окно» элементам управления. Вы можете указывать такие 
параметры, как максимальная длина текста или границы диапазона вводимых чисел. 
После этого У151а1 $ ю генерирует вызовы МЕС-функций, отвечающих за обмен 
данными и проверку их корректности. Эти функции перемещают данные между 
экранными элементами и переменными-членами соответствующего класса. 


Программирование модального 
диалогового окна 


Модальные диалоговые окна встречаются чаще. Пользователь что-то делает (ска- 
жем, выбирает команду в меню), на экране появляется диалоговое окно, пользо- 
ватель вводит данные, а затем закрывает его. Чтобы дополнить существующий 
проект модальным диалоговым окном, сделайте так. 


1. Используя редактор диалоговых окон, создайте диалоговый ресурс с элемен- 
тами управления. Редактор обновит файл описания ресурсов (ВС-файл) ваше- 
го проекта, включив в него новый ресурс, и файл гезоигсе.В, дополнив его со- 
ответствующими константами #4ейпе. 

2. С помощью МЕС С1а$$ УЙлагА создайте класс «диалоговое окно», производный 
от СО#ов, и закрепите его за ресурсом, созданным на шаге 1. У154а! $ш@аю 
добавит в проект требуемый код и заголовочный файл. 


Примечание При генерации производного класса диалогового окна У15ийа1 Знаю 
формирует конструктор, который запускает конструктор СБёщов, при- 
нимающий в качестве параметра идентификатор ресурса. Заголовочный 
файл диалогового окна содержит константу класса 100, которой присвоен 
идентификатор диалогового ресурса. А реализация конструктора в СРР- 
файле выглядит так: 
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ТМИРЕЕМЕМТ _ОУМАМТС (СМу01а109, С01а109) 
СМу01а109: :СМУ01а109(Смпа* рРагеп /*=МУЦ»/) 
С01а109(СМУ01а109::100, рРагепт) 


// здесь должен быть инициализирующий код 


Применение епит 12О избавляет СРР-файл от идентификаторов ре- 
сурсов, определяемых в файле гезоигсе.В данного проекта'. 


3. Добавьте в класс диалогового окна переменные-члены и функции, предназна- 
ченные для обмена и проверки данных. 

4. В окне Ргорегиез утилиты С!а5$ Уле\у добавьте обработчики сообщений для 
кнопок и других (генерирующих события) элементов управления диалогово- 
го окна. 

5. Напишите код для инициализации (в От/ий0 108) элементов управления и для 
обработчиков сообщений. Убедитесь, что при закрытии диалогового окна (если 
только пользователь не нажмет кнопку отмены) вызывается виртуальная фун- 
кция-член ОПОК класса СОов (она вызывается по умолчанию). 

6. В своем классе «вид» напишите код, активизирующий диалоговое окно. Он 
сводится к вызову конструктора вашего класса диалогового окна и последую- 
щему вызову функции-члена РоМоа4 класса диалогового окна. ромМоаа воз- 
вращает управление только после закрытия диалогового окна. 

А теперь рассмотрим все эти операции на примере. 


Пример Ех07а: Диалоговое окно 
«каждой твари по паре» 


Мы не станем возиться с каким-нибудь простеньким примером, а встроим в наше 
диалоговое окно почти все возможные элементы управления. Это несложно — ведь 
нам поможет редактор диалоговых окон \У15ча1 Згаа!о. Готовое диалоговое окно 
показано на рис. 7-1. 

Как видите, это диалоговое окно предназначено для учета кадров. Это пример 
довольно скучного бизнес-приложения — программу слегка оживляют полосы 
прокрутки «1оуаКу» («преданность») и «геНаБШИу» («надежность») — классический 
пример прямого ввода и наглядного отображения данных. Еще интереснее были 
бы здесь элементы управления Асйуех, но использовать их вы научитесь только 
в главе 9. 


Построение диалогового ресурса 


Давайте создадим диалоговый ресурс. 

1. Запустите МЕС АррНсаНоп У/1таг@4 и создайте МЕС-проект Ех07а. Выбс- 
рите в меню ЕЦе последовательно команды Ме\ и Рго]есе. В качестве типа при- 
ложения выберите МЕС АррИсаноп и в качестве имени проекта — ЕхО7а. 


' Файл гезочгсе.В все равно приходится использовать в СРР-файле — для доступа к до- 
черним элементам управления по их идентификаторам. — Прим. перев. 
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те О1а103 Ка Аве Спетпав 


Рис. 7-1. Готовое диалоговое окно в действии 


На странице АррИсайоп Туре мастера установите переключатель в положение 
те оситепи, а на странице Аауапсеа Есагигез сбросьте флажок РипИпе ап4 
рей рге\еу. Остальные параметры оставьте без изменения. 

2. Создайте новый диалоговый ресурс с идентификатором ШО _ОГАГОС1. 
Выберите в меню Рго}есе среды разработки команду ААА Везоигсе и в открыв- 
шемся одноименном диалоговом окне щелкните строку П!а|0®, а затем — кнопку 
Мех’. У1а1 тю создаст новый диалоговый ресурс. 


Редактор диалоговых окон 


91 * 


® 
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Редактор диалоговых окон присвоит новому диалоговому окну идентифи- 
катор ресурса (2О_Г/АГОС1. Заметьте: он вставляет в новое диалоговое окно 
кнопки ОК и Сапсе|. 

3. Измените размер диалогового окна и присвойте ему заголовок. Увеличьте 
размеры окна редактирования, чтобы было удобно работать. 

Щелкните новое диалоговое окно правой кнопкой и выберите в контекст- 
ном меню команду Ргорегиез — откроется одноименное окно (обычно оно рас- 
полагается в правом нижнем углу). 


1002141061 (209) ОКЕВЬО 


Рабе 

рабе 

Рабе 

`100_р1АОб! | 
я Рае , 


Значок кнопки в заголовке окна Ргорегиез определяет ее видимость — при 
нажатой кнопке оно располагается поверх остальных окон. В окне Ргорегие$ 
измените значение свойства СарНоп на «ТВе 0120$ Вох ТВа! Ае Сшсшпай»!, 
а свойства зузет Мепи — на ЕАГЗЕ. 

4. Разместите элементы управления в диалоговом окне. Это делается в окне 
ТооБох. (Если его не видно, выберите в меню \У1е\/ команду Тооох.) Перета- 
щите нужные элементы в создаваемое диалоговое окно, а затем сдвиньте и 
измените их размер (рис. 7-1). Окно Тооох показано ниже. 

вв 

Примечание Редактор диалоговых окон сообщает о положении и размере 

каждого элемента управления в правой части строки состояния. При этом 

координаты выражаются не в аппаратных, а в специальных «единицах 
диалога» (412108 ипи, ОГО). Горизонтальная РТО — это средняя ширина 
шрифта, используемого в диалоговом окне, деленная на 4; вертикальная 

РО — средняя высота этого шрифта, деленная на 8. Ну, а шрифт — это 

обычно М5 5ап$ 5еЁ размером 8 пт. 


' В свободном переводе на русский эту англоязычную идиому с аллюзией на фильм 


«Соскгоасв Шаг а{е Сшсшпай» («Таракан, сожравший город Цинциннати»), можно пе- 
ревести как «диалоговое окно,. охватывающее все возможные элементы управления». 

Мы предпочли перевести название приложения как «Диалоговое окно «каждой твари 
по паре» — Прим. перев. 
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Теперь коротко рассмотрим элементы управления нашего диалогового окна. 

С Статический текст для поля Мате (имя). Этот элемент просто выводит 
на экран указанные символы и собственно к диалогу с пользователем от- 
ношения не имеет. Расположив ограничивающий прямоугольник, введите 
текст (при этом изменится свойство СарНИоп в окне Ргорегиез); размеры 
прямоугольника можно изменить. Создайте текстовое поле Мате и присвой- 
те его свойству СарИоп значение &Машае. Другие статические элементы 
создавайте по аналогии. У них у всех один и тот же идентификатор, но это 
не важно, поскольку доступ к ним программе не нужен. 


Примечание Если в свойстве СарНоп статического текста есть знак амперсанд 
(&), то во время исполнения следующий за ним символ подчеркивает- 
ся. Это значит, что при нажатии клавиши АК и соответствующего сим- 
вола пользователь получает моментальный доступ к относящемуся к ста- 
тическому тексту элементу управления. Причем этот элемент управле- 
ния должен идти в последовательности переходов (гаБЫ пе огаег) сразу 
за статическим текстом. (Мы обсудим последовательность переходов чуть 
позже.) Таким образом, нажатие А+М позволяет «перескакивать» в тек- 
стовое поле Мате, а АИ+К — в поле $КШ (рис. 7-1). Думаю, не стоит го- 
ворить, что подчеркнутые символы должны быть уникальными в рам- 
ках диалогового окна. Именно поэтому в элементе управления 5КШ ис- 
пользуется символ К — ведь $ зарезервирован для поля $$ Мы. 


О Поле ввода Маше. Поле ввода — основное средство ввода текста в диало- 
говых окнах. Смените его идентификатор с РС_ЕМТ1 на ГО2С_МАМЕ. Осталь- 
ным свойствам оставьте значения по умолчанию. Заметьте: Ашо Н$сгой по 
умолчанию устанавливается в ТВОЕ, т. е. текст по мере заполнения тексто- 
вого поля прокручивается справа налево. 

О Поле ввода 5$ №г (5$0с1а1 зесигйу питБег — номер карточки соци- 
ального страхования). Этот элемент управления идентичен предыдуще- 
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му. Замените его идентификатор на /)С_55М№. Впоследствии при помощи 
мастера АЧа МетьЬег УапаЫе УЯ2ага вы превратите это поле в числовое. 


Примечание Чтобы выровнять несколько элементов управления, выделите их 
и выберите команду выравнивания (1ей$, Сегиегз, №1215, Торз, М1а4ез или 
Во(оп5) из подменю АЦгп меню Еогтав. 

Вы также можете выровнять элементы управления по сетке. Чтобы 
включить сетку, щелкните кнопку Тозе Спа (на панели инструментов 
П1а1юз ЕаИог). 


О Поле ввода В10 (Б1оэгарБу — биография). Это многострочное поле ввода. 
Чтобы оно стало таковым, установите свойство МШЯНпе в ТВОЕ. Присвой- 
те ему идентификатор /2С_ВО. 

О Группирующая рамка Сжезогу (категория). Нужна только для визуаль- 
ной группировки двух переключателей. Введите ее название: ©Сщевоту. 
Идентификатор, присвоенный по умолчанию, нас устроит. 

О Переключатели Ноиу (почасовая оплата) и $айагу (оклад). Размес- 

тите эти переключатели в группирующей рамке Сжезогу. Свойство СарНоп 
переключателя Ноийу задайте как /ШС_САТ, а Сгочр и Табор установите в 
ТВОЕ. У переключателя 5а!агу определите свойства: СарНоп — в За!агу, а 
Табор в ТВОЕ. 
Убедитесь, что у обоих переключателей свойство Аиго установлено в ТКОЕ 
(по умолчанию) и что только у кнопки Ноийу установлено свойство Сгочр. 
Последнее означает, что Ноийу — первый переключатель в группе Сжезогу. 
При правильном задании этих свойств УЛ 405 гарантирует, что в установ- 
ленном положении будет только один переключатель. Группирующая рам- 
ка Саезогу на их функционирование не влияет. 

О Группирующая рамка Гл5игаосе (страховка). В этом элементе управ- 
ления размещаются три флажка. Введите название рамки — @/изигапсе. 


Примечание Позже, установив порядок обхода элементов в диалоговом окне, 
вы добьетесь, чтобы группирующая рамка Гпбигапсе следовала за послед- 
ним переключателем рамки Сжезогу. Только не забудьте установить в 
ТВОЕ свойство Огоцр элемента управления Ппзигапсе, чтобы «завершить» 
предыдущую группу. Если этого не сделать, особой беды не будет, но, 
запустив программу под отладчиком, вы получите пару-тройку преду- 
преждений. 


О Флажки М (жизни), 015а Шу (на случай инвалидности) и МеД1са1 
(медицинская). Разместите эти элементы управления в группирующей рам- 
ке шзигапсе. Примите свойства, предлагаемые по умолчанию, но замените 
идентификаторы на [02С_МЕЕ, ШРС _О и ШОС_МЕР. В отличие от переклю- 
чателей флажки ведут себя независимо — пользователь сможет устанавли- 
вать любую их комбинацию. 

О Поле со списком $КШ (профессиональные навыки). Это первый из трех 
типов полей со списком. Изменив идентификатор на /)С_5КШ, установи- 
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те свойство Туре в 5ипрее. Растяните элемент управления в высоту, чтобы 
на нем разместилось несколько строк. Теперь щелкните свойство Ра(а и вве- 
дите, разделяя их точкой с запятой, названия трех профессий: Мапавег (ме- 
неджер), Ргоргапитег (программист) и \тцег («писатель»). 

Этот тип поля со списком называется простым ($итр!е). В верхнем поле ввода 
пользователь может вводить любые данные и при помощи мыши или кла- 
виш-стрелок «вверх» или «вниз» выделять элемент в окне списка. 

С Поле со списком Едис (едисаноп — образование). Замените идентифи- 
катор на 12С_ЕРСС, установите свойство $ог( в ЕАТЗЕ, а у прочих парамет- 
ров оставьте значения по умолчанию. В свойстве ведите три уровня обра- 
зования: НзВ $споо! (старшие классы), СоЦезе (колледж) и Сгадиаие (вы- 
пускник), разделив их точкой с запятой (;). В этом поле со списком пользо- 
ватель сможет набрать все, что ему заблагорассудится, или, щелкнув стрел- 
ку, раскрыть список и выбрать нужный элемент (мышью или клавишами- 
стрелками «вверх» или «вниз»). 

ааа 
Примечание Чтобы задать размер раскрывающейся части поля со списком, 
щелкните стрелку в правой части поля и мышью сместите нижнюю гра- 


ницу вниз. 
ЕО ЧЕМ НИИ ВЫВЕЛО 


С Список Оере (дерагитепе — отдел). Замените идентификатор на /2С_ПЕРТ, 
а у прочих параметров оставьте значения по умолчанию. В этом списке 
пользователь сможет выбрать лишь один элемент мышью, клавишами-стрел- 
ками или введя первый символ нужной строки. Заметьте: у списка нет свой- 
ства Раца, поэтому вы не сможете ввести начальные значения (как это сде- 
лать из программы, вы узнаете чуть позже). 

О Поле со списком Тапз (апопазе — язык). Замените идентификатор на 
1РС_ГАМС и присвойте свойству Туре значение Огор 1454. Введите в свойство 
Раца названия трех языков: ЕпзИ$В (английский), Егепсь (французский) и 
Зрап5В (испанский), разделяя их точкой с запятой (;). В этом поле со спис- 
ком пользователь сможет выбирать элементы только из раскрывающегося 
списка. Для этого он должен, щелкнув стрелку, указать нужную строку или 
ввести ее первую букву и при необходимости уточнить выбор при помощи 
стрелок. 

О Полосы прокрутки ТоуаНу (лояльность) и ВейаБИиу (надежность). 
Не путайте элемент управления «полоса прокрутки» с полосами прокрут- 
ки, встроенными в окно. Элемент «полоса прокрутки» ведет себя так же, как 
и остальные элементы управления, — в частности, в период проектирова- 
ния его размер можно изменять. Разместите горизонтальные полосы про- 
крутки, как показано на рис. 7-1 и присвойте им идентификаторы /2С ГОА! 
ис КЕГУ. 

О Кнопки ОК, Сапсе! и $рес1а1. Введите названия кнопок ОК, Сапсе[и 5@ре- 
си, затем присвойте кнопке $рес!а! идентификатор ШС _$РЕСИШ!Г. Чуть поз- 
же вы узнаете об особом предназначении идентификаторов по умолчанию 
РОК и РСАМСЕГ. 
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О Произвольный значок (для примера показывается значок МЕС). В ди- 
алоговом окне при помощи элемента управления Р1сииге можно отобразить 
любой значок или растровое изображение, если они определены в описа- 
нии ресурсов. Воспользуемся МЕС-значком программы, обозначенным 
1)К_МАМЕКАМЕ. Установите параметр Туре в Гсоп, а Ипазе — в ОК_МАИМЕКАМЕ. 
Идентификатор оставьте /2С_5ТАТИС. 

5. Проверьте порядок перехода между элементами управления. Выбери- 
те из меню Еогта( команду ТаБ Ог4ег. Укажите мышью порядок переключения 
между элементами управления при нажатии клавиши ТаБ. Для этого щелкните 
каждый из элементов управления в следующем порядке и нажмите Еп(ег: 


Совет Если вы перепутали порядок переключения, щелкните последний пра- 
вильно помеченный элемент, удерживая клавишу СИ1. 


© 


Сохраните файл ресурсов на диске. Осторожности ради сохраните файл 
ЕхО7а.тс: выберите в меню Ейе команду $ауе или щелкните одноименную кнопку 
на панели инструментов. Не закрывайте пока редактор диалоговых окон и 
оставьте на экране только что созданное диалоговое окно. 


Создание класса «диалог» 


Теперь вы создали диалоговый ресурс, но без соответствующего класса диалого- 
вого окна работать с ним нельзя. (О взаимосвязи диалогового окна и стоящих за 
ним классов см. раздел «Разбор приложения Ех07а».) При создании этого класса 
используется С1а5$ У1еу и редактор диалогов. 

1. Запустите МЕС С(!а$$ УЛ1лаг4. В С!а35 У1ехуу выберите проект ЕхО7а: 
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$ соБа! РипсНоп5 ап УамаЫе5 
{# 22 Масгоз апд СопвапЕ$ 

8: 2$ САБО 

ее 4 СехО7айрр 

я $ Сехбтабос 

#-9$ Сехо?амем 

89$ смапргате 


Окно С1а$$ \Лем 


В меню Рго]ес! выберите команду Ааа С!а$$ (или щелкните правой кнопкой 
имя проекта в С1а35 У1еу и в контекстном меню последовательно выберите Ааа 
и АЗ С1а$$). В диалоговм окне Аа С!а55 выберите шаблон МЕС С1а5$ и щелк- 
ните кнопку ОК. Откроется окно мастера МЕС С1а$5 УЛлата. 

2. Добавьте класс СЕх07аП ов. Создайте класс на основе базового СОйов, 
заполнив поля окна мастера МЕС (1а$$ УЛгага, как показано на рисунке. Не 
забудьте в поле 012108 Ш задать значение Ш2О_Р/АГОС1, чтобы задействовать 
уже существующий идентификатор. 

МЕС С1а55 \Игаг 9 енота ` 


ТН иЙ2аг 2445 а аз (Ва през гот МЕС Ко усиг рисдесЕ. ОрНопз тау сКапде Черел@па 
‚оп Ве Базе (аз звескед, 


Когда вы щелкнете кнопку Е1$В, в С1а5$ У1е\ появится класс СЕхО7а[ ев, 
а его СРР-файл откроется в редакторе. 

5. Добавьте переменные класса СЕх07 а 408. Добавив класс СЕхО7а ок, 
можно перейти к добавлению переменных-членов средствами мастера Ааа 
Метрег Уама Ме \УЙтага (см. рисунок). Чтобы запустить Ааа МетьЪег УанаЫе 
УЛгага, в С1аз5 Уле\у щелкните класс СЕхО7аГйщов правой кнопкой и в контек- 
стном меню последовательно выберите команды АЯ и Ада УанаЫе. 

Вам надо сопоставить переменные-члены каждому элементу управления 
диалогового окна. Для этого, установив флажок Сопио! УайаЫе, выберите эле- 
мент управления в поле со списком Соптго! Ш и выберите Уаше в поле со спис- 
ком Сэмерогу. В поле УайаЫе Мате ведите имя переменной-члена и определи- 
те другие параметры. Вот пример параметров при добавлении переменной- 
члена т_5иВю типа С$и1т? для текстового поля В1о: 
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Умесоте 10 {пе АЗ Метбег УачаЫе \УЛгаг4 
Тв гаи а445 а тетьег уайаБе Ко убсиг (1а55, вис, ог ипюп. 


— 


Повторите процедуру для каждого из элементов управления, перечислен- 
ных в следующей таблице. При выборе элементов управления в окне АЧа Метьег 
УанаЫез УЛлага можно определить максимальную длину строки или диапазон 
для числовой переменной. Введите для ШС _55М№ минимальное значение 0 и мак- 
симальное — 999999999. 

Большинство связей между типами элементов управления и типами пере- 
менных очевидно. Однако связь между переключателями и переменными не 
столь очевидна. С каждой группой переключателей связывают целочисленную 
переменную, причем первому переключателю соответствует значение 0, вто- 
рому — 1 ит. д. 


о 


Идентификатор 

элемента управления Переменная-член_ Тип Параметры 

ШС_ВЮ п_5В1юо Ст Максимальное число 
символов — 1000 

ШС_САТ т_пСае И 

ОС ФЕРТ па_$иере С$и1п8 

ШС 15 т_Ь11$015 ВООГ, 

ШС_ЕРОС тп_5иЕ4ис С5т8 

ШС ТАМС п_5ИиТаое С$ише 

ШС_ПЕЕ т_Ыа$е ВООГ 

ШС _ТГОУАЕ п_оГоуа| Ш 

ШС_МЕР т_Ып$Меа ВООГ, 

ШС_МАМЕ п_5иМате Ся 

ШС_ ВЕ п_пВеу Ш 

ШС_$КИ п_5и$кШ Сп 

ШС $$5М - т_ 10550 И Минимальное значение — 0, 


а максимальное — 999999999 


Добавьте функцию-обработчик сообщений для кнопки $рес1а1. Классу 
СЕхО7а ов не требуется много функций-обработчиков сообщений, так как 
большую часть работы по управлению диалоговым окном выполняет его ба- 
зовый класс СОйщов совместно с УЛп4оу. Если вы, например, присвоили иден- 
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тификатор РОК кнопке ОК (по умолчанию), при щелчке этой кнопки вызы- 
вается виртуальная функция ОпОК класса СОйщор. Однако для других кнопок 
нужны обработчики сообщений. 

При выбранном классе СЕхО7аГ ов СШазз \1е\и щелкните кнопку Еуеп(5 в 
окне Ргорегиез, чтобы добавить обработчики. В списке должна быть строка с 
идентификатором /2С_$РЕСИГ. Разверните узел 12С_$РЕСШЕ и щелкните сооб- 
щение В№_СИСКЕР. Щелкните стрелку «вниз» рядом с ВМ СИСКЕР: 


Кнопка Емеп{$ 


\У15иа! 5еа(1о предлагает добавить функцию-обработчик ОпВисСйсве$ресии. 
Щелкните <Ааа> ОпВпСЦскеа$рес!а1, чтобы создать ее. У1заа! За10 откроет в 
редакторе файл ЕхО7аП1аюв.срр на строке с функцией ОнВиСисвеа5ресви. За- 
мените существующий код функции выделенным в листинге оператором ТКАСЕ: 


\014 СЕхО7а1а109: :ОпВпС11скеа$рес1а1() 
{ 

ТВАСЕ( "СЕхО7а01а109: : ОпВпС11скеа$рес1а1\п"); 
} 


5. Добавьте функцию-обработчик ОтйО #409. Как вы скоро увидите, У1биа! 
Зо генерирует код, инициализирующий элементы управления диалогово- 
го окна. Однако этот ООХ-код (Г1аю8 Рага Ехсвапзе) не обеспечивает иници- 
ализацию элементов списков, поэтому нужно переопределить функцию СБёа- 
108::ОттИ ов. Хотя ОптиОйщов — виртуальная функция-член, У15иа! $ааю 
создаст для нее прототип и заготовку, если вы решите обработать сообщение 
М ИМТРАГОС в производном классе «диалоговое окно». 

Для этого в окне С!аз5 У1е\у выберите класс СЕхО7аРов, а в окне Ргорегие$ 
щелкните кнопку Оуегиае$. В открывшемся списке выберите функцию Отий- 
1108, щелкните стрелку «вниз» рядом с ней (см. рисунок). 
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————&—&ё&ё&ё&Б5&5&5&5>БЬё>&Б>ё&Б>&5&ёЁ&Б, ЪЁ&Ё&Ё&$5Ъ Щ$;Ъ,>&Ё8&,& 8 ——— 


Кнопка О\ег!де$ 


| СЕнота[заюд УССодеФаз$ 


оптоонктея 


И сБЗВ. ААА: 


<А94> Опт аю9 


нАкретоу 


© слате нер | 


а ааа 


Выберите команду <Ааа> ОпшИГа 102. У15а1 Зеа6о откроет файл ЕхО7аП\а- 


102.срр в редакторе и создаст шаблон функции ОпийОйяор. Замените существу- 
ющий код выделенным текстом: 


ВОО. СЕхО7а01а109: :Оп1п1101а109() 


{ 


// Будьте внимательны: (С01а109: : ОпТп1{01а109 можно вызвать 
// в этой функции только один раз. 

СЕ1зВох» РЕВ = (С1134Вох*) бет019Т+ет(ТОС_ОЕРТ); 
рЕВ->ТпзегЕ$г1п9(-1, “Ооситепфат10т”); 
рЕВ->ТпзегЕ$г1п9(-1, “Ассоип1п9”); 

рЕВ->ТпзегЕ$1г1п9(-1, “Нитап Ве1а%10п$”); 
рЕВ->ТпзегЕ$г1п9(-1, “Зесиглфу”); 


// вызываем после инициализации 
гефигп С01а109: : 0ОпТп1401а109(); 


Этот код инициализирует список Оере с 4 элементами. Для полей со спис- 


ком вместо инициализации в свойстве Райа при желании можно применить 
такую же процедуру. 


Подключение диалогового окна к классу «вид» 


Теперь у нас есть ресурс и код для диалогового окна, но окно не подключено к 
классу «вид». В большинстве приложений диалоговое окно открывается при вы- 
боре какой-либо команды из меню, но пока мы меню «не проходили». Поэтому 
для открытия диалогового окна прибегнем к знакомому сообщению УМ 1ВИТ- 

ТОМРОММ, которое генерируется при щелчке левой кнопки мыши. 

1. Добавьте функцию-член ОШВиноп,оии. Вы уже проделывали это в пре- 
дыдущих главах. Просто выделите имя класса СЕхО7аеи в С]а55$ Мех и в окне 
Ргорегиез щелкните кнопку Ме5зазез. В появившемся списке щелкните стрел- 
ку рядом с сообщением УМ _1ВИТТОМРО\М и выберите <АЯа> ОпГВииопро\п. 
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— Ш 


2. Добавьте код функции ОшШВинопроии в файле Ех07а\У1еуу.срр. Добавь- 
те в заготовку тела функции выделенный код. Большая часть кода состоит из 
операторов ТКАСЕ, выводящих значения переменных диалогового окна после 
того, как пользователь закрыл диалоговое окно. Но главное здесь — вызовы 
конструктора класса СЕхО7аГ ов и функции РоМоаа, 


уо1а СЕхО7а\1ем: : Оп: Ви опбомп ( ИТМТ пР1а9$, СРо1пф ро1п+) 
{ 

СЕх07а01а109 919; 

919.т_з{гМате= “"ЗпаКезреаге, №111"; 


919.т_п$$п = 307806636; 
919.т_пСа* = 1; // 0 = почасовая, 1 = оклад 
919. м_$1гВ10 = “ТВ1з регзоп 1$ поф а ме11-то+1уа+ед теск мг1 Тег"; 


919. п_БТиз1Ре = ТВИЕ; 

919.т_6Тп301$= РАЕЗЕ; 

919.тм_6ТпзМед= ТВИЕ; 

919. м_згОерт= "Боситептат10п"; 

919.т_3{г5К111 = "Игмег"; 

919.т_пЕапд = 0; 

919. м_$ЕгЕдис= “Со11еде"; 

919.т_пЕоуа1 = 919.п_пАе1у= 50; 

1пЕ гет = 919.0оМода1(); 

ТНАСЕ( “ОоМода1 гефигп = Ха\п", геф):; 

ТВАСЕ( "паме = %3, 35п = %4, Воиг1у = 4 за1агу = Ха\п", 
919.п_з+гМате, 919.т_п3зп, 919.т_пСат); 

ТВАСЕ( "дер = %3, 3К111 = $3, 1апд = %4, едис = %з\п", 
919.п_зЕгОере, 919.т_$1г$К111, 919.т_пЕапд, 919.т_згЕдис); 

ТНАСЕ( "11Ре = %4, 913 = %4, мед = 54, Б10 = %$\п", 
919. м_ЬТпзЕ1 Ре, 919.м_6Тп$01$, 919.т_ЬТпзМеа, 919.тм_31гВ10); 

ТВАСЕ( “1оуа1%у = %4, ге11абалачу = *Ч\п”, 
919.п_пЁоуа1, 919.пт_пВе1у); 

} 


3. Добавьте код в виртуальную функцию ОпОгаи в файл Ех07аУ1еу’.срр. 
Чтобы предложить пользователю нажать левую кнопку мыши, добавьте в класс 
СЕхО7аЙеш функцию ОпОтаи (се заготовку сгенерировал мастер МЕС Арр!- 
саНоп \У/Лртага). Замените существующий код выделенным: 


\019 СЕхО7а\1ем: :Оп0гам(СОС* рос) 
{ 

СЕхО7абос* рбос = бе\боситеп+(); 

АЗЗЕВТ_МАЕТО (р0ос); 

роС->ТехЕ0и{(0, 0, “Ргезз +пе 1еРЁ поизе БиЕфоп Пеге. "); 
} 


4. Добавьте в файл Ех07а\У1е\у.срр оператор включения класса «диалого- 
вое окно». Показанная выше функция О/.Вийопроит зависит от объявления 
класса СЕхО7аОйщов. Вы должны включить оператор: 


#1пс1иде “ЕхО7а01а109. в" 


в начало файла с исходным кодом для класса СЕхО7аеи (Ех07а\1еуусрр) после 
оператора: 
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#1пс1и9е “ЕхО7а\1ем. п" 


5. Соберите и протестируйте приложение. Если все сделано правильно, вы 
сможете собрать и запустить приложение ЕхО7а из \У15ча! С++. Попробуйте, вводя 
данные в каждый элемент управления, щелкать кнопку ОК и наблюдать за вы- 
водом операторов ТКАСЕ в окне Ошрие. Полосы прокрутки пока ничего осо- 
бенного не делают — о них речь пойдет позже. Обратите внимание и на то, 
что происходит при нажатии клавиши Еттег в момент ввода текстовых данных 
в каком-либо элементе управления — диалоговое окно сразу закрывается. Вот 
пример трассировочной информации в окне Ошриё 


о 
| паше = Зракезреаке, №111, ззй = 307806636, саь = 1 
ере = Росавенсас1о, $111 = Мк1сек, 187 = 0, ефас = Со11еде 

11е = 1, 413 = 0, шеф = 1, Бо = ТЬ1$ рекзом 1$ пос а че11-шоб1уасе4 сесй мк1оек 
оуа1су = 0, ке11251115у = 0 

ТЬе ркодхаш '1[3480] ехо?а 


| 
| 


Мас1уе' ваз ех1се4 м1 софе 0 (0х0) 


Разбор приложения Ех07а 


После вызова РоМоаа! управление возвратится в программу только после закры- 
тия диалогового окна. Если вам это ясно, значит, вы поняли, что такое модальное 
диалоговое окно. Перейдя к работе с немодальными диалоговыми окнами, вы еще 
оцените простоту программирования модальных диалоговых окон, потому что при 
вызове ДоМоаа/ очень многое остается за кадром. Но вернемся к нашей теме и 
рассмотрим краткую сводку «кто кого вызывает»: 


С01а109: : ОоМода1 
СЕх07а01а109: :ОпТп1{01а109 
...Дополнительная инициализация. .. 
(С01а109:: 0ОпТп1{01а109 
Си\па: :Ордатебата( РАЕЗЕ) 
СЕхО7а01а109: : ВодатаЕхспапде 
пользователь вводит данные. .. 
пользователь щелкает кнопку ОК 
СЕхО7а01а109: :ОпоК 
...Дополнительная проверка. . 
С01а109: : ОпоК 
Смпа: : Урдатебдата( ТВОЕ) 
СЕх07а01а109: : ОодатаЕхспапае 
(01а109: : Еп901а109(Т00К) 


ОттиГщов и РоржаЕхсапве — виртуальные функции, переопределенные в 
классе СЕхО7айщов. УИп9оуз вызывает Отший ов при инициализации диало- 
гового окна, что приводит к вызову РореаЕхсвапве — виртуальной функции класса 
СУта, переопределенной в У!51а! 5910. Взгляните на листинг этой функции: 


\019 СЕхО7а01а109: :БобафаЕхспапде(СВатаЕхспапде» роХ) 
{ 
(01а10о9: : ВобатаЕхспапде(роХ); 
0Х_Техе(рОх, Т0б_ВТО, м_3{гВ10); 
00\/_МахСпагз(роХ, м_з{гВзо, 1000); 
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00Х_Ва@1о(рОХ, ТОС_САТ, т_пСа+): 
0Х_1В$1г1п9(рОХ, ТОС_ОЕРТ, м_з+г0ерт): 
ОХ_Спеск(рбох, 10С_01$, м_1п$01$); 
0Х_СВ$1г1па(рОХ, ТОС_ЕБУС, м_з+гЕдис): 
0Х_СВТпдех(рох, 106_[АМб, м_пЁапд); 
ОХ_Спеск(рох, тос_1ТЕЕ, м_ЬТизЕ1е); 
0Х_5сго11(р0Х, ТОС_1ОУАЕ, м_пЁоуа1); 
0Х_Спеск(рох, 10С_МЕО, ш_оТпзМед): 
ОХ_Техе(рох, Т0С_МАМЕ, м_з+гМамте); 
0Х_5сго11(р0Х, ТОС_ВЕЁУ, т_пВе1у): 
ОХ_СВ$г1п9(роХ, ТОС_$КТИЕ, м_$1г9к111): 
00Х_Техе(рбоХ, 106_99№, т_п9эп); 
00\/_М1пМахТп*(рОХ, п_п5зп, 0, 999999999); 


ооо есо 


РоВреаЕхсратве и функции ООХ_ (обмен) и РБУ_ (проверка корректности 
данных) — «двусторонние». Если Оражершща вызывается с параметром ЕА/5Е, то 
она переносит данные из переменных-членов в элементы управления диалого- 
вого окна, а если с параметром ТКОЕ, то направляет данные из элементов управ- 
ления в переменные-члены. ООХ_1ех! переопределяется для адаптации ко всему 
имеющемуся множеству типов данных. 

Функция ЕпаРйов играет главную роль в процедуре завершения диалогового 
окна. Ромой возвращает параметр, передаваемый в Епарщов. РОК принимает 
данные из диалогового окна, а /ДСАМСЕ, отменяет диалоговое окно. 
поно ана 
Совет Вы можете написать свою «пользовательскую» ООХ-функцию и подклю- 

чить к У15а! С++. Это бывает удобно, если во всей программе вы при- 
меняете уникальный тип данных. Подробнее см. техническую рекомен- 
дацию «ТМ026: ОРХ апа РОУ Воиипез» в интерактивной справочной 
системе. 


Усовершенствование программы Ех07а 


Программа Ех07а, обладая массой возможностей, не требовала от программиста 
особых усилий. Теперь создадим новую версию с расширенной функционально- 
стью. Избавим ЕхО7а от скверной привычки завершать свою работу при нажатии 
клавиши Еп(ег и введем поддержку полос прокрутки. 


Перехват управления при выходе по ОпОК 


В исходной программе ЕхО7а виртуальная функция СРащов::ОпОК обрабатывала 
щелчок кнопки ОК, что запускало обмен данными и процедуру завершения диа- 
логового окна. Как оказалось, клавиша Епиег давала тот же резульгат — может быть, 
это как раз то, что нужно, однако иногда такое поведение неприемлемо. Если 
пользователь нажмет Еп(сг, скажем, при вводе в поле Мате, его сразу «выбросит» 
из диалогового окна. Вряд ли это ему понравится. 

Что же происходит? В момент нажатия этой клавиши У/п4о\$ ищет кнопку, 
на которой установлен фокус ввода (три! Госиз) — на экране он выглядит как 
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пунктирная рамка. Если фокус не установлен ни на одну кнопку, УЛт4о\/$ ищет 
указанную программой или в ресурсе кнопку по умолчанию (аеЁаа ризВБацоп) — 
у такой кнопки более толстый контур. Если и этой кнопки не обнаруживается, 
вызывается виртуальная функция ОпОК — даже когда в окне нет кнопки ОК. 

Клавишу Ет{ег можно отключить, просто написав «пустую» функцию СЕхО7а[4а- 
109::ОПОК и добавив код завершения в новую функцию, реагирующую на щелчок 
кнопки ОК. Последовательность действий такова. 


1. Сопоставьте кнопку ГООК виртуальной функции ОмпОК. В окне С!а$5 Мех 
выберите класс СЕхО7а)йщор, а в окне Ргорегие5 — кнопку Оуегиае$. В открыв- 
шемся списке выберите ОпОК, щелкните стрелку «вниз» рядом с ней и выбе- 
рите <Ааа> ОпОК. \150а1 $610 создаст прототип и заготовку для функции ОпОК. 

2. В редакторе диалогов, измените идентификатор кнопки ОК. Выберите 
кнопку ОК, измените ее идентификатор с ДОК на [)С_ОК и установите в ЕАТЗЕ 
свойство Регаи Вийоп. 

3. Создайте функцию-член ОпСИсЁедОЕ. В окне С!а55$ У1е\ выберите класс 
СЕхО7а ов, а в окне РгорегИе5 — кнопку Еуеп(5. Раскройте узел 2С_ОК, вы- 
берите сообщение ВМ СИСКЕР и, щелкнув стрелку «вниз» рядом с ней, выбе- 
рите <Ааа> ОпВпСИскеаок. 


4. Отредактируйте тело функции ОпСИсведОЕ в Ех07а1П]1а10о5.срр. Она вы- 
зывает функцию ОпОК базового класса, как это делала исходная функция СЁх- 
07а Б109::ОпОК. Вот ее код: 


\0149 СЕх07а01а1о9: :ОпС11скеаок( ) 

{ 
ТВАСЕ( "СЕх07а01а109: : ОпС11скед0к\п”"); 
С01а109: : ОпоК(); 

} 


5. Отредактируйте исходную функцию ОпОК в Ех07а0]1а102.срр. Эта фун- 
кция — «пустой» обработчик кнопки с прежним идентификатором ДОК. Мо- 
дифицируйте код: 


\014 СЕх07а01а10о9: :ОпОК() 

{ 
// заглушка для функции ОпОК - НЕ вызывайте С01а109: : ОпОК() 
ТВАСЕ ( “СЕх07а01а109: :ОпОК\п”); 

} 


6. Соберите и протестируйте приложение. Попробуйте теперь нажать кла- 
вишу Епег. Ничего произойти не должно, но в окне РеБие появится вывод 
оператора ТКАСЕ. Однако щелчок кнопки ОК должен, как и раньше, завкры- 
вать диалоговое окно. 


Обработка ОпСапсе! 


Так же, как нажатие клавиши Еп(ег приводило к вызову ОПОК, нажатие клавиши 
Е5с инициирует вызов ОпСапсер в результате чего диалоговое окно завершается с 
кодом возврата /ОСАМСЕЕ из функции РоМоаа/. Программа ЕхО7а не предусмат- 
ривает особой обработки ШСАМСЁЕ, поэтому нажатие Езс (или щелчок кнопки 
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С!0зе) закрывает диалоговое окно. Вы можете обойти этот процесс, применив 
функцию-заглушку ОпСапсе! по аналогии с тем, что уже делалось для кнопки ОК. 


Подключение полос прокрутки 


Графический редактор позволяет размещать в диалоговом окне элементы управ- 
ления «полосы прокрутки», а АЧ4 Метрег УайаЫе УЛхаг4 — создавать для них 
целочисленные переменные-члены. Чтобы полосы прокрутки ТоуаНу и ВенабИиу 
заработали, надо дополнить программу соответствующим кодом. 

Эти элементы управления позволяют считывать и записывать текущую пози- 
цию бегунка и границы заданного диапазона. Если установить диапазон, скажем, 
от 0 до 100, соответствующая переменная-член со значением 50 поместит дви- 
жок в центр полосы прокрутки. (Функция С5стойВаг::5е5стоЙРо$ тоже задает по- 
зицию движка на полосе прокрутки.) Когда пользователь перемещает движок или 
щелкает стрелки, полоса прокрутки отправляет в диалоговое окно сообщения 
УМ_Н5СКОМ, и УМ_У$СКОМ.. Обработчики сообщений в диалоговом окне расшиф- 
ровывают эти сообщения и изменяют позицию движка на полосе прокрутки. 

Особенность этих элементов в том, что все горизонтальные полосы посыла- 
ют одно сообщение — \УМ_Н$СКОЦМ, а все вертикальные — У\У/М_У$СКОШ. А раз 
в нашем «навороченном» диалоговом окне две горизонтальные полосы прокрут- 
ки, значит, один-единственный обработчик сообщения \/М_Н$СКОШ, должен как- 
то различать, от какой пришло сообщение. 

Добавим в программу ЕхО7а логику управления полосами прокрутки. 

1. Добавьте операторы епит, чтобы задать предельные значения диапа- 
зона прокрутки. Включите в самое начало объявления класса в файле Ех0О7а- 

О1а1о8.В строки: 


епит { ПМ =0 }: 
епит { пМах = 100 }: 


2. Отредактируйте функцию ОттиГ шов, чтобы инициализировать гра- 
ницы диапазона прокрутки. Эта функция должна устанавливать минималь- 
ное и максимальное значения диапазона прокрутки так, чтобы переменные- 
члены СЕхО7а[ 1408 отражали величины, выраженные в процентах: 100 озна- 
чает «установить движок в крайнюю правую позицию», а 0 — «установить дви- 
жок в крайнюю левую позицию». 

Добавьте в файле ЕхО7аО!а10з.срр в функцию-член ОттиО10в класса СЕх- 
07аПщов такой код: 


(С$сго11Ваг» р$В = (С9сго11Ваг») бет019Т{ет(ТОС_ЕОУАЕ): 
р$В->5е{$сго11Напде(пМ1п, пМах):; 

р$В = (С5сго11Ваг») бет0191+ет(ТОС_ВЕЕУ); 
р$В->5е15сго11Вапде(иМ1т, пМах); 


3. Добавьте в СЕхО7а 14 обработчик сообщений от полос прокрутки. 
В окне (1455 Уе\у’ выберите класс СЕхо 7арщов, а затем в окне Ргорегиез щелк- 
ните кнопку Мез5аре$. Выберите сообщение УМ_Н$СКОЦ, и добавьте функцию- 
член ОпН5стой. Введите выделенный код: 
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\019 СЕх07а01а109: :ОпН$сго11(УТМТ п5ВСоае, ИТМТ прРоз, 
С$сго1]Ваг* р$сго11Ваг) 
{ 
1пЕ пТетр1, пТетр2; 


пТетр1 = р$сго11Ваг->бе{$сго11Роз(); 
м1 Есп(п5ВСоде) { 
сазе 5В_ТНУМВРОЗТТТОМ: 
р5сго11Ваг->5е15сго11Роз(пРо$); 
Бгеак; 
сазе $В_|ТМЕГЕРТ: // кнопка “стрелка-влево“ 
пТетр2 = (пМах - пМ1п) / 10; 
1Е ((пТетр1 - пТетр2) > пМ1п) { 
пТетр1 -= пТетр2; 
} 
е1зе { 
пТетр1 = пМ]п; 
} 
р5$сго11Ваг->5е1$сго11Роз(пТетр1) 
Ьгеак; 
сазе $В_1ТМЕВТСНТ: // кнопка “стрелка-вправо” 
пТетр2 = (пМах - пМ1п) / 10; 
1е ((пТетр1`+ пТетр2) < пМах) { 
пТетр1 += пТемр2; 
} 
е1зе { 
пТетр1 = пМах; 
} 
р5сго11Ваг->5е{$5сго11Роз(пТетр1) 
Ьгеак; 


} 


4. Соберите и протестируйте приложение. Вновь соберите и запустите про- 
грамму Ех0О7а. Заработали ли полосы прокрутки? Бегунки должны перемещаться, 
когда вы щелкаете стрелки на полосах прокрутки, а также подчиняться пере- 
таскиванию. (Заметьте: пока в программу не включена логика, позволяющая ре- 
агировать на щелчок пользователем самой полосы прокрутки.) 


Доступ к элементам управления: 
СИ/а-указатели и идентификаторы 


Размечая диалоговый ресурс в графическом редакторе, вы определяете элементы 
управления при помощи идентификаторов, таких как /2С_55М. Однако в программ- 
ном коде бывает нужен доступ к стоящему за элементом управления оконному 
объекту. Поэтому в МЕС-библиотеке предусмотрена функция С\Упа::СеИюПет, 
преобразующая идентификатор в СУяа-указатель. Вы уже видели такое преобра- 
зование в функциях-членах От ов и ОпСИсведОЕ класса СЕхО07аПйщов. Кар- 
кас приложений чудесным образом «создавал» этот С\па-указатель, потому что 
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там не было предусмотрено вызова конструктора для объектов управления. Этот 
указатель временный, и сохранять его нельзя. 


Совет Чтобы преобразовать СУи4-указатель в идентификатор элемента управ- 
ления, задействуйте функцию-член Сей)еСИИО класса Спа. 


Фон диалогового окна 
и цвет элементов управления 


Чтобы изменить фон или отдельные элементы управления в диалоговом окне, 
придется потрудиться. Каждый элемент управления, прежде чем появиться на эк- 
ране, посылает родительскому диалоговому окну сообщение ИМ_СТЕСОГОК. Та- 
кое же сообщение отправляется и самому диалоговому окну. Если написать в про- 
изводном классе диалогового окна обработчик этого сообщения, можно устано- 
вить цвет текста и его фон, а также выбрать кисть для заполнения нетекстовой 
области элемента управления или диалогового окна. 

Вот пример функции ОпСИСоют, задающей желтый фон для всех полей ввода 
и красный фон для диалогового окна. Переменные 7и_РУеПошВтизр и т _РКеаВгизр — 
это переменные-члены типа НВКОЗН, инициализируемые в Опт яюв. Параметр 
псйСоюг определяет тип элемента управления, а рУпа — конкретный элемент 
управления. Чтобы установить цвет одного отдельно взятого поля ввода, нужно 
преобразовать р\па в идентификатор дочернего окна и протестировать его. 


НВВУЗН СМу01а109: :ОпС+1Со1ог(С0С* рОС, С\мпа* рмпа, иТМТ пбС+1Со010ог) 
{ 

11 (пС1бо10ог == СТЕСОЕОН_ЕОТТ) { 
р0С->5еВКСо1ог(В@В(255, 255, 0)):; // желтый 
гетигп тм_ПУе11омВгизй: 

} 

1 (СЕ СоТог == СТЕСОЕОВ_0Е@) { 
роС->5еВкСо1ог(В@В(255, 0, 0)); // красный 
гетигп м_пАеаВгиэп; 

} 

гефигп С01а109: :0пС11Со1ог(рОС, рипа, пС+1Со10г); 

} 


рн 

Примечание Диалоговое окно не размещает \/М_СТЕСОГОЕ в очереди сооб- 
щений; вместо этого оно — чтобы сразу отправить сообщение — вызы- 
вает \/п32-функцию 5епаМе5заве. Это позволяет обработчику сообще- 
ния вернуть параметр, в данном случае описатель кисти. Это не МЕС- 
объект СВги5ь, а \Ит52-объект НВКИЗН. Создать кисть можно, вызвав 
\Лп32-функции СтещебойаВтизр, СтешеНайсЬВгизр и др. 
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Добавление элементов управления 
во время исполнения 


Мы уже видели, как на этапе проектирования с помощью редактора диалоговых 
окон создаются элементы управления диалогового окна. Если вам надо добавить 
элемент управления в период выполнения, придерживайтесь следующей схемы. 


1. Добавьте в свой класс «диалоговое окно» переменную-член для внедря- 
емого элемента управления. Существует несколько МЕС-классов таких эле- 
ментов управления: СВийоп, СЕЙ, СИЯВох и ССотвоВох. Внедряемые объекты 
С++ конструируются и уничтожаются вместе с объектом «диалоговое окно». 

2. Добавьте константу-идентификатор нового элемента управления. Щелк- 
ните правой кнопкой ресурс диалога в Везоигсе У1еу и в контекстном меню 
выберите Везоигсе бутро/!5 — откроется одноименное диалоговое окно. Добавьте 
новую константу. 

3. .С помощью окна Ргорегие$ утилиты С1а$5 У4е\ переопределите функ- 
цию СОйцо2::ОптиО 108. Эта функция должна вызывать функцию-член 
Стеше внедряемого элемента управления. В результате такого вызова в диало- 
говом окне появится новый элемент. УЛп4о\м5 уничтожит окно этого элемен- 
та управления при уничтожении диалогового окна. 

4. Добавьте вручную в производный класс диалогового окна обработчи- 
ки уведомляющих сообщений для нового элемента управления. 


В главе 12 мы попробуем в период выполнения добавить в диалоговое окно поле 
ввода с форматированием (исВ еай сопго!). 


Другие возможности элементов управления 


Вы уже видели, как путем добавления кода в функцию-член ОйттйО ов класса 
диалогового окна настраивается класс элементов управления С5стоЙВаг. Другие 
элементы управления программируются аналогично. Посмотрите в справочнике 
Месгозой Еоипаайоп (1$; тату Кеегепсе список классов, относящихся к элементам 
управления, в частности, обратите внимание на классы СИЯВох и ССотвоВох. 
Каждый обладает рядом свойств, которые окно РгорегИе$ и мастера У1зиа! 510 
напрямую не поддерживают. В частности, некоторые поля со списком поддержи- 
вают выделение сразу нескольких строк при применении стиля [В5$_МИГЛТРЕЕЗЕ!. 
Если вы хотите задействовать эти свойства, не пытайтесь добавлять соответству- 
ющие переменные-члены через С!а$$ У1е\, а определите сами нужные перемен- 
ные-члены и дополните функции ОйтйО 108 и ОпСИсведОЕ своим кодом, отве- 
чающим за обмен нужной информацией. 


Стандартные диалоговые окна \Пптдо\$ 


\УЛпао\з предоставляет набор стандартных диалоговых окон; их поддерживают 
и МЕС-классы (они находятся в файле соп1 $32.41). Вы, вероятно, знакомы с этими 
окнами (всеми или некоторыми), поскольку они используются во многих УЛп9о\- 
приложениях, включая \151а1! С++. Все классы стандартных диалоговых окон про- 
изведены от одного базового класса ССоттопрйщов (табл. 7-1). 
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Таблица 7-1. Классы семейства ССоттопГ!аюд 


Класс Назначение 

ССоотОйщов Выбор или создание цвета 

СЕЙе ров Открытие или сохранение файла 

сЕтаКерасе йщов — Замена в документе одного текста другим 

СРопщов Выбор шрифта из списка доступных шрифтов 

СОеров Применяется для внедрения объектов ОТЕ 

СРавезаирГщов Ввод параметров страницы документа 

СРАПШАЩов Настройка принтера и печать документа 

СРУПШУАжЩОовЕх Печать и предварительный просмотр перед печатью 
в УЛпао\з 2000 


——=—ы———ы5щщ——ыщ——щ—_щ— ААА 


У всех стандартных диалоговых окон общая особенность: они принимают 
информацию у пользователя, но ничего с ней не делают. Скажем, диалоговое окно 
Е|е Ореп помогает пользователю открыть файл, но на деле лишь сообщает про- 
грамме путь и имя выбранного файла — об остальном должна позаботиться сама 
программа. Примерно так же действует и диалоговое окно, предназначенное для 
выбора шрифта: в него вводят параметры шрифта, но оно не создает шрифта. 


Прямое использование класса СЕйеб/аод 


Открыть файл с помощью этого класса очень просто. Вот пример кода, открыва- 
ющего файл, выбранный пользователем в диалоговом окне: 


(Е11е01а109 919(ТВИЕ, “Бтр”, “*. 6тр”); 
11 (919.00оМода1() == ТООК) { 
СЕ11е 111е; 
\УЕАТРУ( 111е.Ореп(а919.бетРа{ИМате(), СЕ11е: : подеВеаа)): 


Первый параметр (ТКОЕ) конструктора указывает, что данный объект — диа- 
логовое окно открытия (ЕЙе Ореп), а не сохранения (ЕШе $ауе) файла; «Бар» — 
это расширение файлов по умолчанию, и +.671р появится в окне ввода имени файла. 
Функция СРИейов::СаРаМате возвращает объект С5ттв, который содержит 
полное имя выбранного файла (с указанием пути). 


Производные классы стандартных диалоговых окон 


Чаще всего классы стандартных диалоговых окон вы будете использовать напря- 
мую. Если же вы решите создать свои производные классы, то сможете расширить 
функциональность стандартных диалоговых окон, не дублируя их код. Однако у 
каждого диалогового окна СОМРГС32 своя специфика. И хотя в следующем при- 
мере мы будем иметь дело с диалоговым окном, предназначенным для работы с 
файлами, он все же даст вам представление об адаптации других стандартных 
диалоговых окон. 


Вложение диалоговых окон 


УЛп32 позволяет «вкладывать» диалоговые окна друг в друга и тем самым выво- 
дить на экран несколько диалоговых окон как единое целое. Сначала нужно со- 
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здать шаблон диалогового ресурса с «дырой» в нем — обычно это элемент управ- 
ления «группирующая рамка» — и присвоить дочернему окну характерный иден- 
тификатор $132 (=0х0451). Далее программа должна установить ряд параметров, 
которые подскажут СОМОГ.С32, что нужно задействовать именно этот шаблон. 
Кроме того, программа должна поставить ловушку (БооК) в цикле выборки сооб- 
щений в СОМОГ.С32, чтобы получить «приоритетный» доступ к определенным 
сообщениям. Проделав эти операции, вы получите диалоговое окно, все еще до- 
чернее по отношению к диалоговому окну СОМОГС 32, несмотря даже на то, что 
ваш шаблон — это «обертка» шаблона СОМОГСЗ2. Все это выглядит сложно и на 
самом деле окажется сложным, если вы не используете МЕС. Работая с МЕС, вы 
создаете шаблон диалогового ресурса и, как уже было сказано, формируете класс, 
производный от одного из базовых классов стандартных диалоговых окон, вклю- 
чаете в Опт щов связующий код, специфичный для конкретного класса, а за- 
тем просто в окне РгорегИе$ создаете обработчики сообщений, поступающих от 
новых элементов управления вашего шаблона. И все. 


Программа-пример Ех07Ь: использование класса СЕЙе[/а/од 


Вы создадите класс, наследующий классу СЕхО7ЬО ов, который добавит в стан- 
дартное диалоговое окно для работы с файлами кнопку Реее аЦ тасЫше Нез 
(«удалить все аналогичные файлы»). Кроме того, он изменит заголовок диалого- 
вого окна и заменит кнопку Ореп на Реее (для удаления отдельных файлов). Вы 
научитесь использовать вложенные диалоговые окна, чтобы добавлять в стандар- 
тные диалоговые окна новые элементы управления. Обновленное диалоговое окно 
активизируется так же, как и в ЕхО7а, — простым щелчком в границах окна пред- 
ставления. Поскольку вы уже должны уметь работать с У15иа1 С++, мы не будем так 
подробно, как раньше, описывать подготовительные операции. Вот как выглядит 
диалоговое окно, создаваемое программой (рис. 7-2): 


уарееге ЕИе 


ЕхО7ЬОос. о] 
ЕхО7Ь\ ем. 06} 
апРит. 06] 
Р | 5ресрИею. 05} 


Рис. 7-2. Диалоговое окно Рае Ейе в действии 


Итак, создаем приложение ЕхО7Ь. 


1. Запустите МЕС Арр/саНоп \/12аг4 и создайте проект Ех07Ь. На страни- 
це АррИсайоп Туре мастера установите переключатель в положение Зтае 
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Чоситепь, а на странице Адуапсеа Ееагиге$ сбросьте флажок Рипипе апа рипе 
ргемеу. Остальные параметры оставьте без изменения. 

2. Создайте новый диалоговый ресурс. Выберите в меню Рго]есЕ среды раз- 
работки команду Ааа Везопгсе и в открывшемся одноименном диалоговом окне 
щелкните строку 0120$, а затем — кнопку Му. У15иа1 ЗтаЧю создаст новый 
диалоговый ресурс. Установите размер диалогового окна равным 3Х5 дюймов 
и присвойте ему идентификатор 2Р_ЕШЕ$РЕСИАЕ. Свойству 51е присвойте 
значение СВНа, свойству Вогаег — Мопе и установите свойства СИр $1Нп2$ и 
УЗЫ в ТВОЕ. 


5. Создайте элементы управления диалогового окна. Удалите кнопки ОК и 
Сапсе!. Создайте кнопку в нижней части диалогового окна с идентификатором 
РС _РЕГЕТЕ, Установите свойство СарНоп в е!е А! МасЫте Ейез. Создайте груп- 
пирующую рамку, в которой присвойте идентификатору значение 532=0х045}, 
а свойству У1Ые — Еа15е: 


Проверьте резульгат своих трудов, щелкнув правой кнопкой диалоговый 
ресурс 12Б_ЕШЕ5РЕСИА в окне Везоигсе У1еу и выбрав в контекстном меню 
Везоигсе 5упБо!5. Список символов должен выглядеть так: 


ЮО_ЕШЕЗРЕЦАЕ 
ОР_О1Е_ММТ_ЕАНЕО 
ОВ_ех07ЬТУРЕ 
ОВ_МАНЕВАМЕ 
ОЯ_МАМЕЕЗТ 

1с32 


4. Используя МЕС С!а$$ УЛ1тагд, создайте класс Среда ЕЙе 1102. В окне С!а5$ 
Уте\у щелкните правой кнопкой проект ЕхО7Ь и в контекстном меню последо- 
вательно выберите Ааа и Ааа С1!а55. В открывшемся диалоговом окне выбери- 
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те шаблон МЕС С1!а5$ и щелкните кнопку Ореп, чтобы запустить МЕС С!а$$ УЙгага. 
Заполните поля мастера, как показано на рисунке. Не забудьте изменить име- 
на файлов на 5ресЕЦе „В и $ресЕЦеП®.срр. К сожалению, мы не сможем выб- 
рать СЕЙеРщов в качестве базового класса в списке Вазе С1а55 — это отсоеди- 
нит класс от шаблона /2О_ЕШЕ$РЕСИ!. Вместо этого придется выбрать Сов 
и сделать замену вручную. Закончив настройку, щелкните кнопку ЕВ. 


Мы 


\!есоте {о {Пе МЕС С1а$$ МЙгаг4 


ТЬ& иугаг4 а445 а Ча5$ Ма пНейез гот МЕС Кю усиг ргодесЕ, ОрНопз тау сНапде дереппа 
оп Ве Базе ‹а55 заесе4. 


Отредактируйте файл $ресЕ|е 0.5. Замените строку: 
с1аз$ СЗрес1а1Е11е01а109 : риб11с С01а109 

на: 
с1а5$ С$рес1а1Е11е01а109 : риб]1с СЕ11е01а109 


Кроме ТОГО, добавьте две открытых переменных-члена класса: 


С$31г1п9 м_31гР11епаме; 
ВОО м_60е1етеА11; 


И, наконец, отредактируйте объявление конструктора: 


СЗрес1а1Р11е01а109(В00Е Б0репЕ11е01а109, 
ЕРСТЗТА 1р320еРЕхф = МИШЕ, 
ЕРСТЗТА 1р$2Е11еМате = МИН, 
МОНО 9мР1ад$ = ОЕРМ_НТОЕВЕАБОМЕУ ; ОЕМ_ОМЕВМАТТЕРВОМРТ, 
ЕРСТЗТН 1р32Е11{ег = МИЦ, 
С№Мпа* рРагепЕМпа = МЕ); 


Замените СОйщов на СЕЙе0 що? в файле $ресЕЙе ]е.срр. Для этого в меню 
ЕЧИ последовательно выберите Е1ша Апа Вер!асе и Кер!асе и замените это имя 
глобально. 


Отредактируйте конструктор С5ресийЕЙе 402 в файле $ресЕ!е .срр. 
Конструктор производного класса должен вызывать конструктор базового 
класса и инициализировать переменную-член 72 _ВРеееАЙ. Кроме того, он 
должен устанавливать некоторые поля в переменной-члене 7и_о/и (базового 
класса СЕЙе 08), которая является экземпляром \/ш32-структуры ОРЕМ- 
ЕШЕМАМЕ. Поля На; и р1етриеМате структуры управляют подключением 
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— 


класса к шаблону /2О_ЕШЕЗРЕС, а поле ряТще изменяет заголовок основ- 
ного диалогового окна. Отредактируйте конструктор: 


(С5рес1а1Е11е01а100: :СЗрес1а1711е01а109(В001 Б0репЕ11е01а109, 
ЕРСТЗТЕ 1р32бегЕхе, ЕРСТ$ТА 1рз2711еМате, ОМОВО дмЕ1адз, 
ЕРСТЗТВ 1р32Е11%ег, С\па* рРагепеИпа) 

: СР11е01а109(Б0репР11е01а109, 1рэз20етЕхе, 1рз7Е11еМате, 
9иЕ1ад$, 1рз2Р114ег, рРагеп\Ипа) 


п_оТп.Р1адз |= ОРМ_ЕМАВЕЕТЕМРЕАТЕ; 
т_оГп. 1рТетр1атемате = МАКЕТМТВЕЗОИВСЕ( Т00_ЕТЕЕЗРЕСТА); 
т_оГп. 1рз{гТ1Е1е = "Ое1ефе Е11е"; 
т_60е1ефеА11 = РА!ЗЕ; 
} 


8. Переопределите функцию Оша! ОЗ аюр в классе С5ресаШЮлищорг. Для этого 
в окне С!а5$ У1еуу выберите класс СбресйииЕйЙеГ/ицов, а в окне Ргорегиез щелк- 
ните кнопку Оуегиае$ и добавьге функцию Оптир ов. Функция-член Оший- 
Риов должна заменить кнопку Ореп в стандартном диалоговом окне на кнопку 
Реве. Идентификатор кнопки — РОК. Отредактируйте код так: 


ВООЕ С5рес1а1711е01а109: :Оп1п1{01а109() 
ВООЕ БАеф = СЕ11е01а109: : ОпТп1=01а109(); 
11 (БВеЕ == ТВУЕ) { 
бетРагеп*( )->бе{0109Т%ем( ТОК) ->5еИ1паомТех+( "Бе1ете"); 
} 
гефигп БВет; 


} 


2. Создайте обработчик новой кнопки ШС ОЕГЕТЕ (реее АП Мас т? 
ЕЦе5) в классе СбресииЕЙе[4иов. Для этого в окне С!аз5 Чех выберите класс 
СбресийЕ йе що, в окне Ргорегиез щелкните кнопку Еуеп($, разверните узел 
ШС _ПЕГЕТЕ и добавьте функцию ОпВиСисвеараеге. Функция-член ОпВиСИсЁед- 
Рае устанавливает флажок т _ВРевеАй, а потом заставляет основное диало- 
говое окно вернуть управление, как будто была нажата кнопка Сапсе!. Клиент- 
ская программа (в данном случае объект «вид») получает РСАМСЕЕ, возвращае- 
мый из РоМоа44, и проверяет флажок, чтобы узнать, надо ли удалить все файлы: 


У019 СЗрес1а1Е11е01а109: :ОпВиС11скеабеле+е() 

{ 
п_60е1е{теА11 = ТВИЕ; 
// 0х480 - идентификатор дочернего окна поля ввода Е11е Мате' 
// (по данным, полученным от ЗРУХХ) 
бетРагеп{( )->5е1019Т4ет(0х480)->бе 4 пдомТехе(т_зЕгЕ11еМапе): 
бефРагепт( )->ЗепаМеззаде (ИМ_СОММАЮО, ТОСАМСЕЕ); 


\ Идентификаторы дочерних элементов управления стандартных диалоговых окон пе- 


речислены в файле 4195. в каталоге Тпс!аае. В частности, для поля ввода ЕЙе Мате 
используется *4ейпе-константа е41. В этом же файле объявлена #Аейпе-константа 
$652. — Прим. перев. 
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10. Добавьте код виртуальной функции Оп)гаи в файл Ех07Б\У1еу.срр. 
Чтобы функция Оп)таш класса СЕхО7Б Ме (заготовку которой генерирует 
мастер МЕС АррИсаНоп УЛгага) предлагала пользователю нажать кнопку мыши, 
закодируем ее так: 


\019 СЕхО76\М1ем: :Опб9гам(С0С»* р0С) 

{ 
СЕх07600с* р0ос = бетВоситептт(); 
АЗЗЕВТ_МУАЕТО(р0ос); 


роС->Тех+0и{(0, 0, “"Ргезз 11е 1еР тоизе БифТоп Пеге. "); 
} 


11.Добавьте в класс СЕхО7Б\еи, обработчик сообщения УМ ГВОГТОМРОЗМ. 
Выделите имя класса СЕхО7Бе в С!а5$ \е\ и в окне РгорегЧе$ щелкните 
кнопку Ме5заеез. В появившемся списке найдите сообщение ИМ _ГВОТГОМРО\УМ 
и, щелкнув стрелку рядом с ним, выберите <Ааа> ОпГВийопроут. 


\01а СЕхО7Ь\1ем: : ОпЕВи{опбомп(ИТМТ пЕ1адз, СРо1пф ро1пт) 
{ 
С$рес1а1Е11е01а109 919Е11е(ТВУЕ, МЕ, "*.06]”); 
С$1г1п9 з+гМеззаде; 
11 пМода1 = 9192711е.ОоМода1() 
11 ((пМода1 == ТОСАМСЕЕ) && (919Е11е.т_60е1етеА11)) { 
зЕгМеззаде. Рогтат( 
"Аге уои зиге уои мапЕ фо де1етфе а11 %$ #11е$?", 
919Е11е.т_з+гЕ11епамте); 
11 (АРхМеззадеВох(з+гМеззаде, МВ_УЕЗМО) == ТОУЕЗ) { 


НАМОЕЕ В; 
ИМТМЗ2_ЕТ№О_ОАТА Тата; 
мп11е ((п = ::Е1п971г$711е(919Е11е.т_31гР11епате, &ГОата)) 


|= (НАМОГЕ) ОхРЕЕРЕРЕЕР) { // МЕС-эквивалента нет 
11 (::Ое1ехер11е(РОата. сЕ11еМате) == РАЁЗЕ) { 
з+гМеззаде. Гогта(/паб1е то де1ете 111е %3\п”, 
Оата. сЕ11еМате); 
АтхМеззадеВох ( з+гМеззаде); 
ргеак; 


} 
} 
е1зе 1Г (пМода1 == ТООК) { 
С51г1п9 31г51п91е[-11епате = 919711е. бетРатИМате(); 
31 гМеззаде. Рогтат ( 
"Аге уои зиге уоиу мап{ То де1ете %3?", 31г51п91еЕ11епаме); 
11 (АГхМеззадеВох(з+гМеззаде, МВ_УЕЗМО) == ТОУЕЗ) { 
СЕ11е: : Ветоуе ( 31г51п91еЕ11епате); 
} 


Как вы помните, стандартные диалоговые окна всего лишь собирают дан- 
ные и не более того. Поскольку объект «вид» является клиентом объекта «диа- 
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ФФ 


логовое окно», он должен вызывать РоМойа! для активизации объекта «выбор 
файлов» (Ше 412108 оБзесо, а затем разбираться, что делать с полученными от 
него данными. В нашем случае у него есть значение, возвращенное функцией 
РоМоам (РОК или [РСАМСЕГ,), значение открытой переменной-члена — флажка 
т_Ьре@еАЙ и информация от ряда функций-членов класса СЕЙе ов (скажем, 
сеРафМате). Если РоМода! возвращает РСАМСЕГ, а флажок — ТКОЕ, он обра- 
щается к файловой системе Х/1п32 и делает вызовы, необходимые для удале- 
ния всех файлов с выбранным расширением. Если же РоМоае возвращает /ООК, 
то для удаления отдельного файла функция может задействовать функции класса 
СЕйе из библиотеки МЕС. 

Применение глобальной функции 'А/хМеззавеВох — удобный способ вызо- 
ва простого диалогового окна, в котором отображается какой-то текст и ко- 
торый запрашивает у пользователя ответ типа «да-нел». Все варианты подоб- 
ных диалоговых окон — их обычно называют информационными (ппеззасе 
Бохез) — и их параметры описаны в документации к У151а[ Зи 10. 

12. Включите заголовочный файл 5$ресЕИе!ГЛ8.Ь в Ех07БУ1еуу.срр. Вам пон: 
добится оператор: 


#1пс1и9е “ЗресР11е019. п” 
который следует вставить после строки: 


Н1пс1и4е "ех07Ь\1ем. п” 


15. Соберите и протестируйте программу Ех07Ь. Щелчок левой кнопки дол- 
жен открывать диалоговое окно Ре|ве ЕЦе, в котором вы сможете просматри- 
вать каталог и удалять файлы. Осторожно: не уничтожьте каких-нибудь важ- 
ных файлов! 


Прочие возможности адаптации СЕИе0/а09 


В примере ЕхО7Ь вы добавили в диалоговое окно одну кнопку. Столь же неслож- 
но добавить и другие элементы управления: просто включите их в шаблон ресур- 
са, и, если это стандартные элементы управления \УИпаАоу'$ (скажем, поля ввода 
или списки), вы сможете вставить в свой производный класс переменные-члены 
и ВОХ/ОЮБУ-код, используя Ааа МетЬег УанаЫе \УЯхага. Клиентская программа 
установит эти переменные-члены перед вызовом функции РоМоаа и получит их 
обновленные значения после возврата из РоМоаеи. 


Примечание Даже если вы не применяете вложенных диалоговых окон, все рав- 
но объекту СЕЙйеБищов сопоставлены два окна. Допустим, вы переопре- 
делили Отти ов в производном классе и хотите присвоить какой- 
нибудь значок диалоговому окну, предназначенному для выбора файлов. 
Тогда вы должны вызвать С\Уиа.:СеРагепЕ, чтобы получить окно верх- 
него уровня по аналогии с тем, что вы делали в программе ЕхО7Ь. 


НТСОМ ВТсоп = АГхбетАрр( )->Еоа9Тсоп(ТО_МУТСОЮ): 


бетРагеп{()->5е{Тсоп(пТсоп, ТВОЕ); // установка крупного значка 
СетРагепт()->Зе{Тсоп(НТсоп, РАТЗЕ); // установка мелкого значка 


— 
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Немодальные диалоговые окна 


Все диалоговые окна, которые мы пока рассмотрели, были модальными. Теперь 
нам предстоит познакомиться с немодальными и стандартными диалоговыми 
окнами для современных версий базового \ИпЧо\5-класса СП1а12. В обеих при- 
меняется диалоговый ресурс, создаваемый в редакторе ресурсов. Если вы плани- 
руете применять немодальное диалоговое окно вместе с объектом «вид», вам при- 
дется освоить несколько особых приемов. 


Создание немодальных диалоговых окон 


Как вы уже знаете, при создании модальных диалоговых окон сначала надо за- 
действовать конструктор СРёяов с параметром-идентификатором прикрепленного 
ресурса, чтобы сконструировать объект «диалоговое окно», а потом вывести мо- 
дальное диалоговое окно на экран, вызвав функцию-член РоМоаа. Окно прекра- 
щает свое существование сразу после возврата из РоМо@4. Таким образом, зная, 
что к тому моменту, когда объект С++ «диалоговое окно» выходит за пределы об- 
ласти видимости, диалоговое окно УЛп4о\/з уже уничтожено, объект «модальное 
диалоговое окно» можно конструировать на стеке. 

Процесс создания немодальных диалоговых окон сложнее. Вы начинаете с 
вызова конструктора СБёяюе по умолчанию, создавая тем самым объект «диало- 
говое окно», а вот нужное диалоговое окно создается вызовом функции-члена 
СРищор::Стесие, а не РоМоаа. Стеше получает идентификатор ресурса как пара- 
метр и сразу возвращает управление; при этом диалоговое окно остается на эк- 
ране. Так что теперь именно вы должны заботиться о том, когда конструировать 
объект «диалоговое окно», когда создавать само диалоговое окно, когда его унич- 
тожать и когда обрабатывать данные, введенные пользователем. 

Различия между созданием модальных и немодальных диалоговых окон тако- 
вы (табл. 7-2): 


Табл. 7-2. Модальные и немодальные диалоговые окна 


ИИ ИИА ИРИНА яя 


Модальное диалоговое окно Немодальное диалоговое 


окно 

Используемый Конструктор с параметром- Конструктор по умолчанию 
конструктор идентификатором ресурса (без параметров) 

Функция, используемая ДоМоаа Стешще с параметром-иденти- 
для создания окна фикатором ресурса 


Пользовательские сообщения 


Допустим, вы хотите, чтобы немодальное диалоговое окно уничтожалось, когда 
пользователь щелкает в нем кнопку ОК. Сразу же возникает проблема. Как объект 
«вид» узнает, что пользователь щелкнул кнопку ОК? Диалоговое окно могло бы 
напрямую обратиться к какой-либо функции-члену класса «вид», но это связало 
бы данное диалоговое окно с конкретным классом «вид». Более удачное решение: 
диалоговое окно при вызове обработчика кнопки ОК отправляет объекту «вид» 
пользовательское сообщение (изег-4ейпе4 плеззазе). Получив его, объект «вид» смо- 
жет уничтожить диалоговое окно (но не сам объект, что позволит ему сохранить 
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все введенные в диалоговом окне данные). Итак, вырисовывается сценарий создания 
нового диалогового окна. 

Есть два варианта отправки \/шп4о%/-сообщений: через функции С\па::5епа- 
Ме5заве или РояМеззаве. Первая вызывает функцию-обработчик сообщения сра- 
зу, а вторая отправляет сообщение в очередь сообщений \/т4о\з. Поскольку 
Роз Ме5заве вносит лишь небольшую задержку, можно считать, что функция-об- 
работчик кнопки ОК уже завершилась, когда объект «вид» получает сообщение. 


Принадлежность диалогового окна 


Теперь предположим, что вы приняли стиль диалогового окна по умолчанию, т. е. 
диалоговое окно не ограничено клиентской областью окна представления. Посколь- 
ку речь идет о \Лп40%, «владелец» диалогового окна — основное окно-рамка 
приложения (см. главу 12), а не объект «вид». Но надо знать, какой именно объект 
«вид» сопоставлен диалоговому окну, чтобы отправить этому объекту сообщение. 
Поэтому ваш класс «диалоговое окно» должен отслеживать свой объект «вид» че- 
рез переменную-член, которую устанавливает конструктор. Параметр рРа’ет! 
конструктора СРйов в данном случае не играет никакой роли. 


Пример Ех07с: немодальное диалоговое окно 


Мы могли бы преобразовать созданное в первой части этой главы диалоговое окно- 
«монстр» в немодальное, но начать все заново, с простого диалогового окна, по- 
жалуй, легче. В программе-примере Ех0О7с диалоговое окно оснащено одним по- 
лем ввода и кнопками ОК и Сапсе|. Как и в ЕхО7а, оно открывается щелчком в окне 
представления, но теперь мы будем удалять его в ответ на другое событие — щел- 
чок правой кнопки в окне представления. Мы будем иметь дело только с одним 
диалоговым окном, поэтому придется позаботиться, чтобы повторное нажатие 
левой кнопки не приводило к появлению дубликата диалогового окна. 

Чтобы кратко объяснить смысл предстоящих операций, скажем, что класс «вид» 
приложения ЕхО7с сопоставляется с единственным объектом «диалоговое ОКНО», 
конструируемым в куче (динамически распределяемой памяти) при конструиро- 
вании объекта «вид». Диалоговое окно создается и уничтожается в ответ на дей- 
ствия пользователя, но объект «диалоговое окно» уничтожается только по завер- 
шении самой программы. 


1. Запустите МЕС АррНсаЧоп У/12аг4 и создайте проект Ех07с. На странице 
АррИсаЧоп Туре мастера установите переключатель в положение эшае аоситепь, 
а на странице Адуапсе4 Ееаагез сбросьте флажок Рипипе апа риши ргемез\ 
Остальные параметры оставьте без изменения. 

2. Вызвав редактор диалоговых окон, создайте новый диалоговый ресурс. 
Выберите в меню Рго}есЕ среды разработки команду Ааа Везоигсе и в открыв- 
шемся одноименном диалоговом окне щелкните строку 0110$, а затем — кнопку 
Меуу. У15ча! 5910 создаст новый диалоговый ресурс с идентификатором 
120_ГАГОСТ. Измените свойство СарНоп диалогового окна на Мо4е!ез$ 101а10®, 
а свойство У15е — на ТВОЕ. Оставьге предлагаемые по умолчанию кнопки ОК 
и Сапсе! с идентификаторами РОК и [ОСАМСЕГ. 
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5. Добавьте элементы управления в диалоговое окно. Вставьте элемент управ- 
ления «статический текст» и поле ввода с идентификатором по умолчанию 
2С_ЕШГТ. Замените заголовок в элементе управления «статический текст» на 
ЕД 1. У вас должно получиться такое диалоговое окно: 


4. Используя МЕС (1а$$ УЛ2аг4, создайте класс СЕх07сП1еор. В окне С1а$$ 
У1еу/ щелкните правой кнопкой проект ЕхО7с и в контекстном меню последо- 
вательно выберите Ааа и Ааа (1255. В открывшемся диалоговом окне выбери- 
те шаблон МЕС С1!а5$ и щелкните кнопку Ореп, чтобы запустить МЕС С!а5$ УЛгага. 
Назовите класс СЕхО7сПйщов, базовым классом выберите СО1ор, а в списке 
Плаюз Ш — 2Б_ РОСТ, как показано на рисунке. Закончив настройку, щел- 
кните кнопку Еш5Б. 


У'есоте {0 {Пе МЕС С1а5$ УЙгага 


ТЫ уигаг а445 а Ча5$ а пез гот МЕС Ко убиг ргодесЕ, ОрНопз тау спапое дереп4 по. 
оп фе Базе аз завскед, 


5. . Добавьте в программу перечисленные ниже функции-обработчики 
сообщений ДСАМСЕГ и ДОК. Выберите класс СЕхО7сОйжов в С!а$$ Уе\ и в 
окне РгорегИез щелкните кнопку Еуеп($. Создайте обработчики сообщений 
ОпВпСискеяСапсе! и ОпВпСИсвея ОЕ: 


Идентификатор объекта Сообщение Имя функции-члена 
ТРСАМСЕЕ ВМ СИСКЕОМ ОпВисисвеаСаисе! 


ШОК ВМ СИСКЕО ОпвисИсвея ОЕ 


6. Добавьте переменную в класс СЕхО7сПщо». В окне С!а5$ Уле\ щелкните 
класс СЕхО7сОщов и в контекстном меню последовательно выберите Ааа и Ааа 
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УапаЫе. В окне мастера АЧа Метьег УамаЫе Х/хага добавьте переменную 
т 5ПЕЧИ1 типа С5ттв к элементу управления /02С_ЕБГГ1: 


49 Метье! УанаЫе Маз о 


\масоте 10 {пе А4Ч Метфег УачаЫе \\Игага 
ТАБ ийгагд а445 а тетфег уаиаЫе ко усиг са, $тис, ог ипюл, 


ПОС ЕОП1 


7. Отредактируйте Ех07сП1а1юов.В, включив в него указатель на объект «вид» 
и прототипы функций. Введите в объявление класса СЕхо 7с0408 выделен- 
НЫЙ КОД: 


рг1уате: 
С\1ем* п_р\У1ем; 


и добавьге прототипы функций: 


риб11с: 
СЕх07с01а109(С\1ем* р\1ем):; 
ВОО Сгеате(); 


ии ааиаацацавнав 


Примечание Применяя класс СУе вместо СЕхО7сИеш, можно использовать 
класс «диалоговое окно» с любым классом «вид». 


О ИВА 
8. Отредактируйте Ех07сП1аюс.В, чтобы определить идентификатор сооб- 
щения УМ_СОООВУЕ. Добавьте строку: 


#аег1пе ММ_СбОООВУЕ ММ_УЗЕВ + 5 


\УИпао\’з-константа УМ_ОЗЕК — первый из числа доступных идентифика- 
торов для пользовательских сообщений. Некоторыми из них оперирует кар- 
кас приложений, поэтому мы пропустим первые пять. 

п мвозвввнвжвманни 

Примечание \15иа| С++ поддерживает в файле гезоигсе. В проекта список сим- 
вольных определений, но не воспринимает константы, базирующиеся 
на других константах. Не добавляйте М_СООРВУЕ в гезоигсе.в вручную, 


потому что У15ча! С++ может удалить ее. 
м 


9. Добавьте конструктор немодального диалогового окна в файл Ех07с- 
012102.срр. Вы могли бы изменить существующий конструктор СЁЕхО7сГеов, 
но, создав отдельный конструктор, вы добьетесь того, что класс «диалоговое 
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окно» станет пригодным как для модальных, так и для немодальных диалого- 
вых окон. Итак, введите строки: 


СЕх07с01а109: :СЕх07с01а109(С\У1ем» р\У1ем) // “немодальный” конструктор 
У ЗЕРВОСТСТС”" 
{ 

т_р\У1ем = р\У1ем; 


} 


Вы должны также вставить в «модальный» конструктор, сгенерированный 
МЕС АррИсаНоп У/Лгага, строку: 


ТМРЕЕМЕМТ_ОУМАМТС(СЕх07с01а109, С01а109) 
СЕх07с01а109: :СЕх07с01а109(С\па* рРагеп{ /*=МИЕЕ*/) 
: С01а109(СЕх07с01а109::100, рРагепф) 
АЕ РБ") 


п_р\У1ем = МЕ; 


Компилятор С++ достаточно «сообразителен», чтобы отличить немодальный 
конструктор СЕхО7сГяюв(СИеш»*) от модального СЕхО7сПов(Ста*). Обна- 
ружив аргумент класса СИе или производного от него класса Се, он гене- 
рирует вызов немодального конструктора, а увидев аргумент класса Са или 
производного от него класса, — вызов модального конструктора. 

10. Введите в Ех07с01а102.срр функцию Сгеше. Эта функция производного 
класса диалогового окна вызывает аналогичную функцию базового класса, 
передавая идентификатор диалогового ресурса как параметр. Вставьте строки; 
ВОО СЕх07с01а109: :Сгеате() { 


гефигп С01а109: : Сгеате (СЕх07с01а109: :100); 
} 


Примечание Функция Стеше не является виртуальной. При желании ей мож- 
но подобрать и другое имя. 


11. Отредактируйте функции ОиВпиСИсвейСапсё и ОпВпСИсЕедОЕ в Ех07с- 
012102.срр. Эти виртуальные функции, сгенерированные мастером С1а$$ У1еу’, 
вызываются в ответ на щелчки кнопок в диалоговом окне. Введите выделен- 
НЫЙ КОД: 


\019 СЕх07с01а109: : ОпВпС11скеаСапсе1 () 
{ 
1е (п_р\У1ем 1= МЕ) { 
// немодальное диалоговое окно - не вызывать ОпСапсе1 из базового класса 
п_р\1ем->Роз+Меззаде(ММ_бО00ОВУЕ, ТОСАМСЕГ) 
} 
е1зе { 
С01а109: : ОпСапсе1(); // если диалоговое окно является модальным 
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у014 СЕх07с01а109: : ОпВпС11скедок( ) 
{ 
ТР (т_рУ1ем != МЕ) { 


// немодальное диалоговое окно - не вызывать ОпОК из базового класса 
Ордатерата(ТВИЕ); 
п_р\1еи->Роз{Меззаде(ИМ_б000ВУЕ, ТООК); 

} 

е1зе { 


С01а109::0пОК(); // если диалоговое окно является модальным 


} 


Если диалоговое окно используется как немодальное, оно отсылает объек- 
Ту «вид» пользовательское сообщение УМ _СООРВУЕ. Его обработку мы обсу- 
дим позже. 
ааа 
Внимание! Применяя немодальное диалоговое окно, ме вызывайте функций 
СРащов::ОпПОК или СРБёщов::ОпСапса. Это значит, что вы обязаны пере- 
определить эти виртуальные функции в своем производном классе, иначе 
нажатие клавиш Езс или Егиег либо щелчок кнопок мыши приведут к 
вызову функций базового класса, которые обращаются к УЛпаоу-фун- 
кции ЕпаОй4о8в. Последняя подходит только для модальных диалоговых 
окон. В немодальном диалоговом окне вместо нее нужно вызывать Ре- 
тоутаои», а чтобы переправить данные от элементов управления ди- 
алогового окна переменным-членам класса, вызывайте Иражерейа. 


12. Отредактируйте заголовочный файл Ехо7сУ1е\.В. Для хранения указате- 
ля на объект «диалоговое окно» нужна соответствующая переменная-член: 


рг1уате: 
СЕх07с01а109* т_р019; 


Если вы добавите в начало файла Ех07с\1е\.В упреждающее объявление: 


С1аз$ СЕх07с01а109; 


вам не придется включать ЕхО7сП!а1о8.В в модули, содержащие ЕхО7с\еу\ В. 

15. Модифицируйте конструктор и деструктор класса СЕх07сИеи, в Ех07с- 
Улеу.срр. В классе СЕхО7сИеи» есть переменная-член т _ РГО, которая указы- 
вает на относящийся к представлению объект СЕхО7сП ов. Конструктор объек- 
та «вид» формирует объект «диалоговое окно» в куче, а деструктор объекта «вид» 
уничтожает последний. Введите выделенный код: 


СЕхО7с\У1 ем: : СЕх07с\У1ем() 
{ 

п_р019 = пем СЕх07с01а109(+11$); 
} 


СЕхО7с\У1ем: : "СЕх07с\У1ем() 
{ 
Че1ефе п_р019; // уничтожает окно, если оно еще не уничтожено 
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14. Добавьте код к виртуальной функции Оп)гаи) в Ех07сУ\У1еу.срр. Функ- 
цию Опргаи класса СЕхО7сИеи», шаблон которой создает мастер МЕС Арр!сайоп 
УЛгага, нужно запрограммировать так, чтобы она предлагала пользователю 
щелкнуть кнопкой мыши: 


№019 СЕхО7с\1ем: : Оп0гам(С0С* рос) 

{ 
СЕх07с0ос* р0ос = бе{боситептт(); 
АЗЗЕВТ_МАЕТО(р0ос); 


роС->Тех+0и*(0, 0, “Ргезз Не 1еРЕ тоизе Биффоп пеге.“) 
} 


15. Создайте обработчики сообщений мыши УМ ГВОТТОМРОУМ и УМ _ЕВОТ- 
ТОМОО\М в СЕх07сИеи». Выберите класс СЕхО7с\еш в С1а5$ Уех, в окне 
Ргорегиез щелкните кнопку Меззаяез, создайте обработчики сообщений Ой/Вш- 
юпроит и ОпКВиНопроиш, а затем отредактируйте код в файле ЕхО7с\1е\мусрр: 


№0149 СЕхО7с\1ем: : ОпЕВифопбомп(УТМТ пЕ1ад$, СРо1пт ро1пт) 
{ 
// создает диалоговое окно, если оно еще не создано 
11 (м_р019->бефбатеНмпа() == 0) { 
п_р019->Сгеафе(); —// отображает диалоговое окно на экране 
} 
} 
\014 СЕхО7с\1ем: : ОпВВиттопОомп(ИТМТ пР1адз, СРо1пф ро1пт) 
{ 
п_р019->без+гоум1п9ом( ); 
// ничего страшного, если окно уже уничтожено 


Функция Резтоу\Йтаош не уничтожает объект С++ — это верно для окон 
почти всех типов, кроме основных окон-рамок. Именно такого ее поведения 
мы и добиваемся, так как объект «диалоговое окно» мы уничтожаем только в 
деструкторе объекта «вид». 

16.Дополните файл Ех07сУ1еу.срр оператором #1ипс[аде для заголовочно- 
го файла диалогового окна. Вставьге этот оператор после оператора, вклю- 
чающего заголовочный файл класса «вид»: 


#1пс1и9е “ЕхО7с\1ем. п” 
#Н1пс1и9е “Ех07с01а109. 1” 


17. Напишите код обработки сообщения УМ _СООЮВУЕ. Поскольку С!а$$ У1е\ 
не поддерживает пользовательские сообщения, этот код придется написать 
вручную. Здесь-то вы и сможете оценить, какую работу проделывает У15ча1 $10 
для других сообщений. 


Добавьте в файл Ех0О7с\1еу’срр следующую строку между операторами ВЕ- 
СМ_МЕЗЗАСЕ_МАР и ЕМО_МЕЗЗАСЕ_МАР: 


О№_МЕЗЗАСЕ (\М_СОООВУЕ, Опбооаруе) 


Кроме того, вставьте в этот файл саму функцию-обработчик сообщения: 
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ГВЕЗУЕТ СЕхО7с\1ем: : Опбоодруе (МРАВАМ мРагат, ЕРАВАМ 1Рагат) 
{ 

// сообщение, получаемое в ответ на щелчки кнопок 

// ОК и Сапсе1 в немодальном диалоговом окне 

ТВАСЕ( “СЕхО7с\1ем: : Опбоодбуе %х, %1х\п", мРагам, 1Рагат); 

ТВАСЕ( "01а109 е9141 сопфепе$ = %$\п" 

(сопзЕ спаг») тм_р019->м_$гЕа1+1) 
т_р019->0езгоум1паом(); 
гефигп 01; 


В файл ЕхО7с\1еу.В поместите прототип функции (сразу за прототипами 
аЁх_плз8 функций ОтЁВийопроит и ОпКВийотроит): 


аГх_тз9 ЕВЕЗУЕТ Опбоодруе(МРАВАМ мРагат, [РАВАМ 1Рагат):; 


В \!132 параметры шРагат и !Ратат — обычный путь передачи данных, 
содержащихся в сообщении. Например, в сообщении о нажатой кнопке мыши 
в [Рагат упаковываются координаты х и у курсора мыши. В МЕС-библиотеке 
данные, включаемые в сообщение, передаются через параметры с более внят- 
ными именами. Те же координаты курсора передаются как объект СРО. В то 
же время в пользовательских сообщениях применять шРагат и [Рагат обяза- 
тельно, так что в любой момент вы можете задействовать эти две переменные. 
В этом примере в параметр шРагат мы записывали идентификатор кнопки. 
18. Соберите и оттестируйте приложение. Соберите и запустите программу 
Ех07с. Попробуйте нажать левую кнопку мыши, а затем правую. (В последнем 
случае курсор мыши должен быть вне диалогового окна.) Вновь вызовите ди- 
алоговое окно на экран, введите какие-нибудь данные в элементе управления 
Вай 1 и щелкните в диалоговом окне кнопку ОК. Правильно ли отображает 
оператор ТКАСЕ (объекта «вид») содержимое поля ввода? 
пня 
Примечание При использовании классов «вид» и «диалоговое окно» из про- 
граммы Ех07с в каком-нибудь МП1-приложении у каждого дочернего окна 
может быть по одному немодальному диалоговому окну. Закрытие до- 
чернего окна МП1-приложения приводит к тому, что его немодальное 
диалоговое окно уничтожается, так как деструктор объекта «вид» вызы- 


вает деструктор объекта «Диалоговое окно». 
м 


ГЛАВА 


Стандартные 
элементы управления 


В главе 7 вы познакомились с такими элементами управления М1сгозой УЛп4оуз, 
как кнопка (Баиоп), флажок (сВеск Бох), переключатель (га@юо Бийоп), статичес- 
кий текст ($айс ехерох), список (15 Бох) и поле со списком (согаБо Бох). В этой 
главе вам предстоит познакомиться еще с одной группой стандартных элемен- 
тов управления (соттоп сопго)). Код этих элементов управления содержится в 
файле Ушао\$ СОМСТЕЗ 2.2, а номер самой последней версии этой библиоте- 
ки — 6.0. В ней обновлены существующие и добавлены новые элементы управле- 
ния. В Мсгозой У15ща! С++ и Мсгозой ЕоипааНоп С]а$$ (МЕС) существенно улуч- 
шена поддержка этих новых элементов управления. 


Примечание Версия установленной в системе СОМСТТ.3 2.0, определяется 
версиями ОС УЛп4о\5 и М1сгозой Ицегае( Ехр|огег. Эта библиотека име- 
ется в УЛюао\з 95, но отсутствует в УЛа4о\з МТ 4.0 — во всех последую- 
щих версиях (в том числе \/Ит4о\ 2000/ХР) она есть. Она также постав- 
ляется в составе Мисгозой пиегпеЕ Ехр!огег версии 3.0 и более поздних. 

Для верности и чтобы на иметь неприятностей со «старыми» систе- 
мами, стоит позаботиться о поставке последней версии СОМСТТЕ3 2.01, 
в составе дистрибутива своего приложения. Обновить СОМСТЕЗ 2.011, 
можно, установив последнюю версию Ицегпе! Ехр/огег. Иногда доступ- 
ны наборы компонентов с обновленными версиями библиотек, в ко- 
торые включена СОМСТТ3 2.011. Самую свежую информацию о СОМ- 
СТТ.32.01, см. в статье «Веди Биноп о СОМСТТ3 2.01» (0186176) спра- 
вочника Мсгозой Кпоидеаве Вабе, а также на сайте компании М1сгозой 
по адресу Вир: //тзаплистозой.сот. 
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—— 
Знакомство со стандартными 

элементами управления 


К стандартным элементам управления относятся индикатор хода процесса (ргозтез$ 
шасагог), ползунок (5Наег сопи ор, наборный счетчик (зрш сопи о), графический 
(1156 сопго]) и древовидный список (1хее сопго|) (рис. 8-1). 


Рис. 8-1. Стандартные элементы управления таоих 


Элемент управления «индикатор хода процесса» 


Индикатор хода процесса — самый простой в программировании стандартный 
элемент управления; он представлен МЕС-классом СРговтез Ст, Обычно его ис- 
пользуют только для вывода информации. Для инициализации индикатора хода 
процесса в функции ОимийГ ов вызываются функции-члены 5$еКапве и 5еРоз; 
после этого при необходимости вызывается 5еРо$ из обработчиков сообщений. 
Значения индикатора хода процесса на рис. 8-1 лежат в диапазоне 0-100 (это 
диапазон по умолчанию). 


Элемент управления «ползунок» 


Ползунок (иногда в англоязычной литературе его называют паскБаг) представ- 
лен классом С5й4етСШ! и позволяет вводить «аналоговые» значения. (Ползунки были 
бы, пожалуй, очень уместны в полях ГоуаШу и ВейаБИШу примера ЕхО7а в главе 7.) 
Если задать для этого элемента управления большой диапазон (например, от 0 до 
100 или более), ползунок будет перемещаться очень плавно, а если малый (ска- 
жем, от 0 до 5) — скачками. Программно можно создать шкалу, деления которой 
соответствуют шагу (дискретности) движения ползунка. Именно в таком режиме 
работает ползунок, позволяющий в окне свойств экрана выбирать текущее раз- 
решение. Диапазон по умолчанию у ползунков отсутствует. 

Ползунок программировать легче, чем полосу прокрутки, так как не надо раз- 
бирать сообщения УМ_Н5СКОИ, или УМ_У$СКОШ. в классе «диалоговое окно». После 
установки диапазона ползунок можно перемещать мышью или щелкая деления 
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шкалы. И все же, если вы хотите отображать значения, связанные с положением 
ползунка, в другом элементе управления, работать с сообщениями о прокрутке все 
же придется. Текущее положение ползунка возвращает функция-член Се!Роз. 
В диалоговом окне на рис. 8-1 верхний ползунок плавно перемещается в диапа- 
зоне от 0 до 100, а нижний — дискретно в диапазоне от 0 до 4, и эти индексы свя- 
заны со значениями двойной точности (4.0, 5.6, 8.0, 11.0 и 16.0). 


Элемент управления «наборный счетчик» 


Наборный счетчик (класс СзртВийопСИ) — это уменьшенный вариант полосы 
прокрутки, который обычно используется совместно с полем ввода. Поле ввода 
слева от наборного счетчика (в последовательности переключения между элемен- 
тами управления по нажатию клавиши ТаБ оно располагается непосредственно 
перед счетчиком), иногда называют его «спутником» («Биааду»). Суть работы дан- 
ного элемента в том, что пользователь, поместив курсор на счетчик и удерживая 
левую кнопку мыши, может увеличивать или уменьшать («набирать») число в поле 
ввода. Скорость «набора» тем выше, чем дольше удерживается кнопка мыши. 

Если приложение оперирует в поле ввода с целыми числами, можно вообще 
обойтись без программирования на С++. Просто закрепите за полем ввода (стан- 
дартными средствами У\151а1 $1410) целочисленную переменную-член и не забудьте 
установить диапазон значений счетчика в функции ОшийОйяор. (Скорее всего вам 
не понравится диапазон наборного счетчика по умолчанию: от минимального 
значения 100 до максимального 0.) Не забудьте установить свойства Ашо Виаау и 
её Виаау Ицезег наборного счетчика в ТВОЕ. Для изменения диапазона и схемы 
ускорения «набора» значений можно вызывать из Опт ов функции-члены 
5аКапве и 5айссе|. 

Чтобы в поле ввода отображались нецелые значения (например, время или числа 
с плавающей точкой), надо создать обработчик сообщения УМ_У5СКОМ, (или 
УМ _Н5$СКОШЫ,) от наборного счетчика и предусмотреть в обработчике преобразо- 
вание целых значений наборного счетчика в числа, отображаемые в поле ввода. 


Элемент управления «графический список» 


Этот элемент управления (класс С1[4СИ)) вводят, если нужен список, способный 
отображать не только текст, но и графику. На рис. 8-1 он отображает список с 
маленькими значками. Элементы располагаются столбцами, поэтому данный эле- 
мент управления содержит горизонтальную полосу прокрутки. Когда пользователь 
выбирает какой-то элемент, элемент управления отправляет уведомляющее сооб- 
щение, которое вы должны обработать в своем классе «диалоговое окно». Обра- 
ботчик сообщения определяет, какой именно элемент выбран. Элементы обознача- 
ются целочисленными индексами, начиная с 0. 

И графический, и древовидный списки получают отображаемые ими картин- 
ки от стандартного элемента управления — списка изображений (итазе 150 (класс 
Ставе4$1). Ваша программа должна формировать список изображений из знач- 
ков или растровых изображений, а затем передавать элементу управления «гра- 
фический список» указатель на этот список. Формировать список лучше всего в 
функции ОттйО ов, там же можно определить и нужные текстовые строки. Вста- 
вить элемент в список позволяет функция-член /и5еШет. 
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Программировать графический список несложно, если ограничиться только 
строками и значками. Если же вы хотите обеспечить поддержку агаз-ап4-@гор или 
включить в список более сложную, определенную самим пользователем графику, 
придется потрудиться. 


Элемент управления «древовидный список» 


Вы уже знакомы с этим элементом управления, если работали с программой 
УПпаоуу Ехрюгег (Проводник) или окном проекта в бомНоп Ехр]огег среды \У1з0а! 
Зиаю. МЕС-класс СТгееСТ позволяет легко добавить в вашу программу такие же 
возможности. Древовидный список на рис. 8-1 иллюстрирует состав одной аме- 
риканской семьи. Пользователь может раскрывать и свертывать элементы, щел- 
кая кнопки «+» и «—» или дважды щелкая сами элементы. Значок, расположенный 
рядом с каждым элементом, программируется так, чтобы вид его изменялся, ког- 
да элемент выбран одинарным щелчком. 

У графического и древовидного списков есть ряд общих черт: эти списки мо- 
гут работать с одним и тем же списком изображений и совместно использовать 
одни и те же уведомляющие сообщения. Однако методы идентификации элемен- 
тов у них разные. В древовидном списке вместо целочисленных индексов при- 
меняется описатель НТКЕШТЕМ. Для добавления новых элементов служит функ- 
ция-член /изе’Шет, но перед этим нужно сформировать структуру ТУ Л\ЗЕКТУТЮОСТ, 
которая (помимо прочего) идентифицирует строку, индекс в списке изображений 
и описатель родительского элемента (МОИМ, для элементов верхнего уровня). 

Как и графические, древовидные списки предоставляют безграничные возмож- 
ности настройки. Можно, например, разрешить пользователю редактировать, встав- 
лять и удалять элементы. 


Сообщение И/М_ МОТПЕУ 


Раньше элементы управления УЛп4о\з посылали свои уведомления в сообщени- 
ях "М_СОММАМО. Однако стандартных 32-разрядных параметров шРагат и [Ратат 
недостаточно для передачи всей информации из стандартных элементов управ- 
ления их объсктам-родителям. М1сгозой решила проблему «пропускной способ- 
ности», введя новое сообщение ИМ_МО’ИЕУ. При отправке такого сообщения шРа- 
’ат содержит идентификатор элемента управления, а (Рагат служит указателем 
на структуру ММНОК, поддерживаемую данным элементом управления. На языке 
С эта структура определяется так: 


Туредег зфгисЕ тадммМнов { 
НИМО ПмпадЁРгот; // описатель элемента управления, отправляющего сообщение 


ИТМТ 19Ргом; // идентификатор элемента управления 
ИТМТ соае; // особый, характерный для этого элемента код’ уведомления 
} ММНОВ; 


Однако многие элементы управления посылают сообщения УМ_МОТИЕУ с ука- 
зателями на структуры более крупные, чем ММНОК. Эти структуры содержат не 
только показанные выше три поля данных, но и дополнительные, характерные 
для конкретного элемента управления. Например, во многих уведомлениях из 
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древовидных списков передается указатель на структуру ММ _ТКЕЕЕТ, содержащую 
структуру ТУ /ТЕМ и другие данные. Поэтому, сопоставив обработчику сообщение 
У\У/М_МОТТЕУ, \У15ща1 $ ю генерирует указатель на соответствующую структуру. 


Пример Ех08а: стандартные элементы управления 


Мы не станем изобретать реальную программу, в которой используются все эле- 
менты управления, — просто включим их в модальное диалоговое окно. 


1. Запустите МЕС АррНсаНоп У/12аг4 и создайте проект Ех08а. Выберите в 
меню ЕШе последовательно команды М№е\ и Рго]есе. В качестве типа приложе- 
ния выберите МЕС АррИсайолп и в качестве имени проекта — ЕхО7а. На стра- 
нице АррИсайНоп Туре мастера установите переключатель в положение шее 
Чоситепь, а на странице Аауапсеа Ееагиге5 сбросьге флажок РипИпе апа рип: 
рге\меху. Остальные параметры оставьте без изменения. Закончив настройку, 
щелкните кнопку Е111$В. 

О других свойствах пока не беспокойтесь — вы установите их на следую- 
щих этапах. (Элементы управления могут выглядеть иначе, чем на рис. 8-1, пока 
вы не установите их свойства.) 

2. Создайте новый диалоговый ресурс с идентификатором ШО ПЛАГОС1. 
Выберите в меню Ргоесе среды разработки команду Ааа Везоигсе и в открыв- 
шемся одноименном диалоговом окне щелкните строку 0110$, а затем — кнопку 
Меуу. У15ца[ $ создаст новый диалоговый ресурс Перетащите нужные эле- 
менты с панели инструментов Тооох (если она не видна, выберите в меню 
Уте\ команду Тоорох.) в создаваемое диалоговое окно, а затем разместите их 
и измените размер. В таблице перечислены типы элементов управления и их 
идентификаторы. После настройки свойств СарНоп в диалоговом окне долж- 
ны быть следующие элементы управления и порядок обхода: 


З сойарзед Моде 
В геаЁ 
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Тип элемента Идентификатор дочернего окна Порядок обхода 
Статический текст ШС 5ТАПС 

Индикатор хода процесса 1Ш2С_РКОСКЕ$5 1 2 
Статический текст ШРС _$5ТАПС 5 
Ползунок 1рС _$МОЕК1 4 
Статический текст РС _5ТАПС _$ИОЕК1 5 
Статический текст ШС 5ТАПС 6 
Ползунок ШС _$ИРЕК2 7 
Статический текст Ш2С_5ТАИС $ИРЕК2 8 
Статический текст ШРС $ТАПС 9 
Поле ввода 2С_ВИРБУ $РМ1 10 
Наборный счетчик ШРС _$ЫМ1 11 
Статический текст Ш)С _5ТАГС 12 
Статический текст ШС _5ТАПС 13 
Графический список Ш2С_И$ТИЕТ1 14 
Статический текст ШРС _5ТАИС_М5УТИЕМУ1 15 
Статический текст ШС 5ТАПС 16 
Древовидный список Ш)С_ТКЕЕЙЕУ1 17 
Статический текст РС _5ТАПС_ТКЕЕМЕЯ1 18 
Командная кнопка РОК 19 
Командная кнопка ШРСАМСЕГ 20 


С ОЕ АОИ Е ЕЕ ВЬЕТНАМ, 

53. С помощью МЕС С(1а$$ УЛ12таг4 создайте новый класс СЕх08а0 10$, про- 
изводный от СОйщ08. Чтобы запустить МЕС С!а$$ УЛлага, в С!а55 Уле\/ щелк- 
ните класс СЕхО8а0 08 правой кнопкой и в контекстном меню последователь- 
но выберите команды АЧ4 и АаЧ С1а35. В качестве базового выберите класс 
СПов, а в списке Г1аюз Ш выберите РБ П/АГОС1: 


МЕС (25$ МАгаьд - Еыб8а 


У’асоте то Пе МЕС С!а$$ МЙгагд 


ТН ийгагф а445 а с1а5$ ВВаЁ пней гот МЕС Ко усиг ргодесЁ, ОрНопз тау ‘сВапде дерепдпа 
‚оп Не Базе (аз с@ескед, 


4. Переопределите функцию ОштйО110?2 и создайте обработчики сооб- 
щений ИМ _Н$СКОП и УМ _УУСКОЦ.. Для этого в окне С!аз5 У1е\у выберите 
класс СЕхОЗаГ ов, в окне Ргорегие$ щелкните кнопку Оуегиаез и создайте 
функцию Оптй[ ав. В окне Ргорегиез щелкните кнопку Меззаес$ и создайте 
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функции-обработчики ОпН5стой и ОпУустой событий М_Н$СКОМ, и ИМ _У- 
$СКОЦ, соответственно. 


Запрограммируйте индикатор хода процесса. Так как У15иа| 5410 не ге- 
нерирует переменную-член для этого элемента управления, сделайте это вруч- 
ную. Добавьге в заголовок класса СЕхОЗа ов открытую (риБШс) целочисленную 
переменную-член 7 иРговте5; и присвойте ей в конструкторе значение 0. Кроме 
того, добавьте в функцию-член Оттйр#08 код: 


// Индикатор хода процесса 
СРгодгез$Стг1* рРгод = 

(СРгодгез$С+г1*) 6ет0191тет(ТОС_РАОбВЕЗ$1); 
рРгод->3е{Вапде(0, 100); 
рРгод->5е1Роз(м_пРгодгезз); 


. Запрограммируйте «непрерывный» ползунок. Добавьте в заголовок клас- 
са СЕхОЗаГ 105 открытую целочисленную переменную-член 7"_пТгасЁЬат! и 
присвойте ей в конструкторе значение 0. Затем дополните функцию-член 
ОпттиГ ов следующим кодом, который устанавливает диапазон, а также на- 
чальное положение по значению переменной-члена; в соседнем поле стати- 
ческого текста задается число, соответствующее положению ползунка. 


// Ползунок 
С51г1п49 э&гТех{1; 
С9119егС{г1* р5114е1 = 

(С3119егС+г1*) бе+0191Т{ет(ТОС_ЗЕТОЕВТ); 
р5114е1->5е1Напде(0, 100); 
р5119е1->5е1Роз(т_п$114ег1); 
этгТехе1. Рогта*("%9", р5119е1->бетРоз()); 
$е10191+етТех+ (Т0С_ЭТАТТС_ЗЕТОЕВТ, $%гТехе1); 


Чтобы можно было обновлять статический текст в соответствии с текущим 
положением ползунка, создайте обработчик сообщения УМ_Н5СКОМ, которое 
ползунок передает объекту «диалоговое окно». Код обработчика выглядит так: 


\019 СЕх08а01а109: :ОпН5сго11 (ИТМТ п5ВСоде, ИТМТ пРо$, 
(С$сго11Ваг* р5сго11Ваг) 
{ 
6С$119егС+г1* р$114е = (65114егСЕг1*) р$сго11Ваг; 
С$4г1п9 зфгТехт; 
з+гТехф. Рогта*( "%9", р$119е->бетРоз()); 
$е+0191{етТехе(10С_5ТАТТС_5ЕТОЕВ1, з%гТехе); 


Наконец, вам надо обновить переменную-член 772_и5И4ет1, когда пользова- 
тель щелкнет кнопку ОК. Так и тянет включить этот код в обработчик кнопки 
ОпОК. Но тогда, если в каком-нибудь из других элементов диалогового окна 
выявится ошибка при проверке корректности введенных данных, вам не из- 
бежать проблем. Обработчик установит 72_пи5Йа4ет1, даже если пользователь 
«отменит» диалоговое окно. Поэтому код надо вставить в функцию Робша- 
Ехсрапре. И если вы сами проверяете корректность введенных данных, то, 
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обнаружив ошибку, вызовите СРеаЕхсрапве::Еай — она откроет информаци- 
онное окно и уведомит пользователя о допущенной им ошибке. 


\014 СЕхО8а01а109: :обатаЕхспапде (СбатаЕхспапде* рох) 
{ 
11 (р0Х->т_Ь6ЗауеАпа\а11да+е) { 
ТВАСЕ( “ирдат1п9 3114ег дата тетьегз\п”); 
С$114егСЕг1* р3114е1 = 
(С$114егС%г1»*) бет019Т4ет(10С_$1ТОЕВ1); 
т_п$114ег1 = р$119е1->бе{Роз(); 


С01а109: : ВорафаЕхспапде(рОХ); 
} 


7. Запрограммируйте «дискретный» ползунок. Добавьте в заголовок класса 
СЕхОва[лаюв открытую целочисленную переменную-член т _и54е2 и обну- 
лите ее в конструкторе. Эта переменная-член служит индексом для ЯИшие — 
закрытой статической переменной-члена, которая представляет собой массив 
чисел (4.0, 5.6, 8.0, 11.0 и 16.0). Определите Маше в файле ЕхО8аП1а1ое.В как 
закрытый статический массив чисел двойной точности: 


ЭфаЕ1с доибЛе а\а1ие[5]; 


а в файл ЕхО8аГ1аюэ.срр добавьте строку: 
Чоир1е СЕх08а01а109: :9\а1ие[5] = {4.0, 5.6, 8.0, 11.0, 16.0}: 


Потом дополните функцию-член Оптййщов кодом, определяющим диапа- 
зон ползунка, разметку шкалы и начальное положение: 


С$1г1п9 з{гТехЕ2; 
($119егСЕг1* р5114е2 = 

(С$119егС&г1*) бе{0191Т+ет(ТОС_ЗЕТОЕВ2): 
р5119е2->5$е1Вапде(0, 4): 
р$1149е2->5е1Ро$(м_п51149ег2); 
зЕгТехта. Рогтаф ( "#3. 1+”, @\а1ие[р$119е2->ве{Роз( м 
$е1019ТтетТех{ (Т0С_УТАТТС_У1ТОЕВ2, з+гТехт2): 


Если б был только один ползунок, обработчик сообщения УМ_НУСКОМ,, о 
котором говорилось на шаге 5, вполне мог бы сработать. Но в программе два 
ползунка посылают одно и то же сообщение УМ_Н5СКОМ, и обработчик дол- 
жен разобраться в них. Код следует изменить так: 


У01а СЕх08а01а109: :ОпН$сго11 (ИТМТ пзВбоае, ИТТ пРо$, 
(С$сго11Ваг* р3сго11Ваг) 
{ 
С$114егСЕг1* р$114е = (С$1149егС+г1*) р$сго11Ваг: 
С$1г1пд9 з1гТехе; 


// два ползунка посылают сообщения 

// НЗСВОЕЕ (нужна разная обработка) 
Зи ЕсП(р$сго11Ваг->6е+019С4г110()) { 
сазе ТОС_ЗЕТОЕАТ: 
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эЕгТехт. Рогма{ ( "#4", р5119е->бетРоз()); 
$е101911етТехт(Т0С_5ТАТТС_ЗЕТОЕВЛ, $з%гТех{); 
Ьгеак; 

сазе ТОС_5ЕТОЕН2: 
эЕгТехе. Рогмат( "Х3.1+Р", 9\а1ие[р$119е->бетРоз()]); 
$е10191Т+етТехЕ(1Т0С_$ТАТТС_ЗЕТОЕВ2, $+гТех+); 
Бгеак; 


} 


В ползунке 5Наег2 нужна шкала с делениями, поэтому установите свойства 
иск Магк$ и Ащо 'Т1сК$ этого элемента управления в ТВОЕ. Последний пара- 
метр заставит ползунок пометить делениями каждое приращение. Если деле- 
ния не видны, увеличьте высоту элемента управления. 

Для этого ползунка справедливы те же рассуждения по поводу проверки 
данных, что и для предыдущего. Поэтому вставьте в функцию-член Рорея- 
Ехсфапве класса «диалоговое окно» в {-блоке, созданном на предыдущем шаге, 
такой код: 


(С5114егС1г1» р5114е2 = 
(С5119егС{г1») бе{0191Т{ет(ТОС_$ЕТОЕН2); 
п_п5114ег2 = р5119е2->бе{Роз(); 


Через редактор диалоговых окон задайте значение Воцот/Ё121( свойству 
Рош! обоих ползунков, а свойству АПеп ТехЕ элементов управления /2С_ТКАСК- 
ВАК1 и ШС _ТКАСКВАК2 — значение ЕВ! 11. 

Запрограммируйте наборный счетчик. Наборный счетчик связан со сво- 
им спутником — полем ввода, всегда предшествующим счетчику при переме- 
щении между элементами управления клавишей ТаЬ. Средствами Ааа Метрег 
УанаЫе УЛгагА добавьте переменную-член двойной точности 7т1_@5рт для поля 
ввода РС _ВИРРУ $РМ1. Мы используем тип дои МЕ вместо #й только из-за того, 
что последний практически не требует программирования и задача была бы 
чересчур проста. Мы хотим установить диапазон поля ввода от 0.0 до 10.0, но 
сам счетчик оперирует только с целыми числами. Чтобы открыть окно масте- 
ра Ааа Метьег УанаЫе УЙгага, в С!а$$ У1е\ выберите класс СЕхОва)йщов, а 
затем — команду Ааа УайаЫе из меню Рго]ес!. Настройте свойства класса так: 


ГРАЧ Метьег УанаЫе 4 - Екова 


| \Мекоте $0 {пе АВА Метьег Уанаще \Игаг4 
} ТН& '\гаг а445 а тетбег уайаЫе Ко уоиг <4а5$, звиисё, ог ипюп. 
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Добавьте следующий код в ОптйП ов, чтобы установить диапазон его 
значений от 0 до 100 и присвоить ему начальное значение т_а5рт * 10.0: 


// Наборный счетчик 

СЗр1пВи{ТопСЕг1* рЭр1п = (СЭр1иВиопСг1 +) бе{019Т+ет( ТОС_5РТМ1) 
р$р1п->5е{Вапде(0, 100); 

р$р1п->35е1Роз( (111) (м_аЗрап * 10.0)) 


Чтобы текущее значение счетчика отражалось в связанном с ним поле вво- 
да, нужно предусмотреть обработчик сообщения ИМ УУСКОМ, которое счет- 
чик отправляет в объект «диалоговое окно». Вот этот код: 


\014 СЕх08а01а109: :0п\$сго11(ИТМТ п5ВСоде. итмт пРоЗ, 
С$сго11Вагя р$сго11Ваг) 
{ 
11 (п5ВСо4е == ЗВ_ЕМОЗСАОЕ.) { 
гефигп; // Отбрасываем ненужные сообщения 
} 
// Обрабатываем сообщения о перемещениях только от ТОС_ЗРТМ1 
11 (р$сго11Ваг->6е+01964г110() == ТОС_5РТМ1) { 
С51г1п9 зЕг\а1ие; 
зЕг\/а1ие. Рогтат( "3.1", (дои61е) пРоз / 10.0); 
( (СЗр1пВиопСг1*) р$сго11Ваг)->бетВиаду( ) 
->5еМ1пдомТех+ ( з+г\а1ие); 
} 


С01а109: :Оп\/Зсго11 (п5ЗВСоде, пРоз, р$сго11Ваг); 


Вводить какой-то код в ОПОК или РореаЕхсратве не нужно, так как содер- 
жимое поля ввода обрабатывает ООХ-код (Р1а108 Рага ЕхсВапзе), отвечающий 
за обмен данными в диалоговом окне, В редакторе диалоговых окон задайте 
значение ТКОЕ свойству Ашо Виаду наборного счетчика и свойству Веаа-ошу 
связанного со счетчиком поля ввода. 

9. Подготовьте список изображений. Этот список необходим и графическо- 
му, и древовидному списку, а в самом списке нужно создать значки (1с01п5). 
Значки вы найдете в каталоге ЕхОВа\гез на компакт-диске — разноцветные 
кружки с черной границей. Если у вас есть значки поинтереснее, используйте их. 

Прежде чем импортировать значки в проект ЕхО8а, скопируйте их в папку 
ЕхОЗа\гез проекта. Выберите в меню Рго}есе среды разработки команду Ааа 
Везоигсе и в открывшемся одноименном диалоговом окне щелкните кнопку 
Ипром. В диалогом окне пром перейдите в папку с файлами значков. В поле 
со списком ЕЦез оЁ гуре выберите тип файлов — 1соп ЕЦез, выберите файлы с 
Гсоп04со по 1соп741со и щелкните Ореп. Значки откроются в редакторе изоб- 
ражений и появятся в папке [соп в окне Везоигсе \1еу’. В окне Ргорегие$ опре- 
делите идентификаторы (Г) значков и закройте редактор значков. 
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Файл значка Идентификатор ресурса 
Гсоп04со ШГ МУНПТЕ 

[с0п14со Ш ВГАСК 

1с0п24со Ш КЕР 

1соп34со Ш ВГОЕ 

1с0141со ШГ УЕЦНОЙ 

[с0п54со Ш СУАМ 

1сопбАсо Ш РОКРЕ 

1с0п74с0 ШТ СКЕЕМ 


По завершении этой операции папка 1соп в Везоигсе У1е\’ должна выгля- 
деть так: 


Теперь добавьте в заголовочный файл класса СЕхОЗаГ ов открытую пере- 
менную-член 77_йпаве[1$ класса С/тазе[15 и включите в ОттИОщов такой код: 


// Тсоп$ 

НТСОМ ВТсоп[8]; 

И 

т_1тадеЕ1 $1. Сгеате(16, 16, 0, 8, 8); // или 32 - для больших значков 

ВТсоп[0] = АЁхбетАрр()->Гоа9Тсоп(ТОТ_МНТТЕ); 

ВТсоп[1] = А|хбетАрр()->Гоа9Тсоп(ТОТ_ВЕАСК); 

ВТсоп[2] = АЁх@етАрр()->ЁГоааТсоп(ТОТ_ВЕО); 

пТсоп[3] = АРхбетАрр() ->[оадТсоп(ТОТ_ВИШЕ): 

ВТсоп[4] = АЁх@етАрр( )->ГоааТсоп(ТОТ_УЕЕЕОМ): 

В1соп[5] = АРхбетАрр( ) ->ГоадТсоп(ТОТ_СУАМ); 

В1соп[6] = АРхбетАрр( ) ->ГоадТсоп(ТОТ_РИВРЕЕ); 

ВТсоп[7] = АЁхбефАрр( ) ->ГоааТсоп( ТОТ_СВЕЕМ); 

Рог (п=0; п < 8; п++) { 
т_1тадеЕ1$*, Ааа (пТсоп[п]); 

} 
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_ Несколько с слов о значках 


Вероятно, вы. знаете, что растровое изображение, или ‚растр, — это массив 
битов, представляющих пикселы на экране. (О растровых изображениях мы 
говорили в главе 6.) В \/пт4оуу$ значок — это целый «пучок» растров. Прежде 
всего надо понимать, что размеры у значка зависят от растровых изобра- 
жений. Для представления мелкого значка применяется изображение 16х16 
пикселов, а для крупного — 32х32. Для каждого размера существует два от- 
дельных растра: один (4 бита/ликсел) для цветного изображения и, как маска, 
один монохромный (1 бит/пиксел). Если бит маски равен 0, соответствую- 
щий пиксел изображения представляет непрозрачный цвет. Если же бит 
маски равен 1, то при черном (0) цвете изображения данный пиксел про- 
зрачен, а при белом о - цвет фона в нае этого пиксела а 
 Маненькие значки появились в \/т40\$ 95. ыы используются на пане- 
ли задач (газКЪаг), в Упао\з ЕхрЮгег и вуже упомянутых элементах управ- 
ления, если программисты предусматривали их, Если у значка нет растро- 
ВОГО изображения для размера 16х16 пикселов, \Илао\ сформирует умень- 
шенный вариант (маленький значок) из растра для размера 32%32 пиксе- 
ла, но тогда он уже не получится таким ‘аккуратным, как специально нари- 
сованный в разрешении. 16х16. Графический редактор позволяет создавать 
и редактировать значки. Вот как выглядит его палитра цветов: 


Щелкните эту кнопку, 
чтобы инвертировать цвет пиксела 


Щелкните эту кнопку, — 
‚чтобы получить прзрачный цвет пиксела 


Верхний квадратик в верхнем левом углу окна палитры показывает ос- 
новной цвет для кистей, заливки фигур и пр., а квадратик пониже указыва- 
ет на цвет границ фигур. Основной цвет выбирается щелчком левой кноп- 
ки, а цвет границ — щелчком правой. Теперь взгляните на центр верхней 
части окна палитры. Щелчок верхнего значка монитора позволяет рисовать 
прозрачные пикселы (изображаются темно-голубым цветом), а нижнего — 
инвертированные пикселы (изображаются красным цветом). 
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10.Запрограммируйте графический список. В редакторе диалоговых окон 
установите свойства графического списка, как показано в таблице. 


Свойство элемента управления Значение 
Айоптет Тор 
Айоауз $рош 5аесйоп Тгие 
5тае 5аесйопт Грие 

Иеш Я 


Затем введите в Отт #08 код: 


// Графический список 
зтафас спаг» со10ог[] = {"“миае”, “Б1аск”, “гед”, 
"“Б1ие”, “уе110ом", “суап”, 
"“ригр1е”, “дгееп”}; 
СЕ1$СЕг1* рЕ1$ф = 
(СЕ131С1г1*) 6е10191Ттет( ТОС_ЕТУТУТЕМ); 
рЁ11->5е{ТтадеЕ131(&т_1тадеЕ1$+, Е\У$ТЕ_$МАЕЕ); 
пом (аи 8 $ 
рЕ1$4->ТпзегЕТ{ет(п, со1ог[п], п); 
} 
рЁ1з+->Зе4{ВкСо1ог(В@В(0, 255, 255)); // Тихий ужас!! 
рЁ1$4->5е4Тех{ВкСо1ог(АбВ(0, 255, 255)); 


Как показывает последняя строка, со стандартными элементами управле- 
ния сообщение УМ СТЕСОГОК не используется — функция вызывается для уста- 
новки цвета фона Вы просто вызываете специальную функцию. Однако, как 
вы увидите, запустив программу, инвертированные пикселы значков выглядят 
весьма убого. 

Если вы создадите обработчик уведомляющего сообщения /УМ_/ТЕМСНАМСЕР 
из графического списка, то сможете отслеживать выбор элементов пользова- 
телем. В окне С!а$$ У!е\ выберите класс СЕхО8аОйов, в окне Ргорегиез щелк- 
ните кнопку Еуеп(з, разверните элемент С _115Т\Е\Т1, выберите событие 
[УМ [ТЕМСНАМСЕР и добавьте функцию-обработчик ОпГоиПетсрапзейвилеш 1. 
Добавьте в нее следующий код для отображения текста выбранных элементов 
списка в статическом элементе управления (метке): 


\019 СЕх08а01а109: : Оп упТетспапдедЕ1$\/1ем1 (ММНОВ* РАМНОВ, 
|ВЕЗИЕТ» рВези1т) 
{ 
ЕРАМЕТЗТУТЕМ РАМЕМ = ге1пфегрге{_саз<ЕРММЕТ$ТУТЕМ> (рММНОВ); 
СЕЗЗЕСЕг1» РЕЗ = 
(С11$С1г1*) беЕ019Т+ет(ТОС_ЕТЗТУТЕМ1); 
1пЕ п5е1]естед = р№МЕУ->11ТТепт; 
11 (пЗе1естед >= 0) { 
С$1г119 зЕгет = рЁ131->бетТ{етТехЕ(п$е1есфеа, 0); 
$е101914етТех{ (Т0С_$ТАТТС_\Т$ТУТЕМ1, з+гТ%ет); 
} 
*рАези1т = 0; 


164 Часть И Основы МЕС 


—э—з—»—м————»з»——_ 


В структуре ММ_М$ТИЕ\ есть переменная-член ет, содержащая индекс 


выбранного элемента списка. 


11.Запрограммируйте древовидный список. В редакторе диалоговых окон 
установите атрибуты стиля элемента управления «древовидный список»: 


Свойство элемента управления 


На$ Вийопи$ 
На$ 14пе$ 
4пез АЕ Кобо! 
стой 


Значение 
Тгие 
Тгие 
Тгие 
Тгие 


Затем вставьте в Ой/тйОов строки: 


// Древовидный список 


СТгееСтг1» рТгее = (СТгееС+г1*) бе{0191+ет(Т0С_ТВЕЕУТЕМТ); 
рТгее->5е{ТтадеЁ1$1 (&п_1таде!1$+1, ТУУТЕ_МОВМАЕ): 
// значения, общие для всей древовидной структуры 


Т\/_ТМЗЕАТУТНАУСТ ф\1пзеге: 
у1пзеге. ПРагепЕ = МЕ; 


Тутпзеге. пТпзегтАЕ ег = ТУТ_|АЯТ; 
\утпзеге. 1{ет.тазк = ТУТЕ_ТМАСЕ 


ТУТЕ_ТЕХТ; 
Ту1пзегт. 1%ет. ПТфет = МЕ 
у1пзеге. 11ет,зтафе = 0; 
у1пзеге. 11ет. зкатемазк = 0; 
\у1пзегт. 11ет. сспТехЕМах = 6; 
Тулпзеге. 1{ет. 15е1естедТтаде = 
Ту1пзеге. 11ет. сСп11дгеп = 0; 
\у1пзегт. 1Тет. 1Рагам = 0; 

// верхний уровень1 


\у1пзегт. 11ет. рз7Техе = “Нотег" 


у1пзегт. 1тет. 1Ттаде = 2; 


ТУТЕ_ЗЕЪЕСТЕОТМАСЕ ! 


НТАЕЕТТЕМ ПОад = рТгее->ТпзегЕТ{ет( &&\1пзег+): 


Ту1пзегЕ. 1{ет.рзхТехЕ = “Магде“; 


НТВЕЕТТЕМ ПМот = рТгее->ТизегЕТ{ет( &Ем1пзег+): 


\у1пзегт. ПРагеп* = пбаа; 


\1пзегт. 1{ет. рзтТехЕ = “Ваг+” 


Ту1пзегт. 1Тет. 1Ттаде = 3; 
рТгее->ТизегЕТТет(&\1пзегЕ); 


\у1пзеге. 11ет. рз2Техе = “11а” 


рТгее->ТпзегЕТтет( &\у1пзег{): 
// второй уровень 
\у1пзегт. пРагеп* = ВМом; 


фулпзеге. 1{ет. рз7Тех{ = “Ваг+“ 


{у1пзегт. 1{ет. 1Ттаде = 4; 
рТгее->ТпзегЕТ+ет( &у1пзег\); 


\У1пзеге. 11ет. рз2Техе = "[15а”; 


рТгее->ТпзегЕТ{ет( &\1пзегЕ) 


\1пзеге. 11ет. рз7Техе = “0116еге”; 


, 


НТВЕЕТТЕМ ПОфпег = рТгее->ТпзегЕТ+ет( &+у1пзегЕ) 
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// третий уровень 

ТулизегЕ. ПРагеп{ = пОтпег; 
фулпзеге. 11тет. рз2Техе = “Бодбегт” 
Ту1пзегт. 11ет. 1Ттаде = 7; 
рТгее->ТпзегЕТ{ет( &+у1пзегт); 
Т\1пзегт. 11ет.рз7Тех{ = “Аафбегт”; 
рТгее->ТпзегЕТТет( &{\1пзег{); 


Как видите, этот код устанавливает в ТУ ПИМЗЕЮТУТЮОСТ текст и индексы 
изображений, а затем вызывает [75е7Шет для создания узлов в древовидной 
структуре. 

И, наконец, создайте обработчик уведомления 1ТУМ_$ЕСНАМСЕР от элемента 
управления «древовидный список». В окне С1а55 У1е\ выберите класс СЕхОЗа- 
Рав, в окне Ргорегиез щелкните кнопку Еуеп!, разверните элемент /2С_ТКЕЕ- 
ИЕ\Т, выберите событие ТУМ_ЗЕГСНАМСЕР и добавьте функцию-обработчик 
ОпТоп5есрапвеЯТтеелеш1. Добавьте выделенный код для отображения выбран- 
ного текста в статическом элементе управления (метке): 


\014а СЕх08аб1а109: :ОпТуп5е1спапдедТгееу1ем1 (ММНОВ»* рАММНОВ, 
ВЕЗУТ» рВези1{) 
{ 
ЕРАМТНЕЕ\УТЕМ рАМТгее\1ем = ге1пфегрге*_сазт<ЕРАМТВЕЕМТЕМ> (рммнов; 
СТгееС+г1* рТгее = (СТгееС+г1») бе{0101+ет(ТОС_ТВЕЕУТЕМТ); 
НТАЕЕТТЕМ пЗе1есфед = р№МТгее\1ем->1+етМем. пТтет; 
1е (п5е1естед != МЫ) { 
спаг 1ех{[31]; 
ТУ_ПЕМ Цеп; 
1{ет.тазк = ТУТЕ_НАМОЕЕ ; ТУТЕ ТЕХТ; 
Чет. пТтет = п5е1естед; 
1{ет. рз2Техф = тех; 
11ет. сспТехЕМах = 30; 
\УЕНВТРУ( рТгее->бетТ{ет( &11ет)); 
$е+019Т+етТех{ (10С_$ТАТТС_ТВЕЕУТЕМ1, +ехф); 
} 
*рНези1т = 0; 


В структуре ММ_ТКЕЕЙЕ\ есть переменная-член ЙетМ№ и», содержащая ин- 
формацию о выбранном узле, а точнее его описатель. Функция сеет отыс- 
кивает данные, относящиеся к этому узлу, и получает текст, используя указа- 
тель, хранящийся в структуре ТУ /ТЕМ. Переменная таз сообщает \Лп4о\, 
что описатель РИет достоверен и что нужно вернуть текст. 

12. Отредактируйте виртуальную функцию ОиОгаи в файле Ех08аУ1еуу.срр. ' 
Выделенный код заменяет существующий: 


у014 СЕхО8а\1ем: :Опбгам(СОС* рос) 

{ 
СЕх08абос* рбос = бе{боситептт(); 
АЗЗЕВТ_\МАЕТО(р0ос); 


роС->Техе0и(0, 0, “Ргезз {пе 1еРЕ тоизе Биффоп пеге."); 


7—2064 
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13. Добавьте функцию-член ОшШВиноп,ои. В окне С!а$$ \!еу выберите класс 
СЕхО8аПйщор, в окне РгорегИез щелкните кнопку Меззаеез, выберите сообще- 
ние УМ _[ВОТГОМРОУМ и добавьте функцию-обработчик Ой[Винопроит. От- 
редактируйте код, как показано ниже: 


\019 СЕхО8а\1ем: : ОпЕВи{фопбомп(ИТМТ пЕ1адз, СРо1п ро1п*) 
{ 
СЕх08а01а109 919; 


919.т_п5119ег1 = 20; 

919.т_п$114ег2 = 2; // индекс для 8.0 
919.т_пРгодгезз = 70; // только запись 
919.м_95р1п = 3.2; 


919. 0оМода1(); 


СМ1ем: : ОпЕВифопбомп (пЕ1ад$, ро1пе); 


Чтобы включить файл ЕхО8аГ1аов.В в файл ЕхОЗа\1еуусрр, добавьте оператор: 


#1пс1иде “Ех08а01а109. 1" 


14. Скомпилируйте и запустите программу. Поэкспериментируйте с элемен- 
тами управления, чтобы увидеть, как они работают. Индикатор хода процесса 
мы с вами не запрограммировали — о нем поговорим в главе 13. 


Дополнительные стандартные элементы управления МИп4ом$ 


К дополнительным стандартным элементам управления \/п4оу%/з относятся эле- 
мент выбора даты и времени (4а{е ап ите р/сКег), календарь на месяц (топи 
саепааг), элемент ввода адреса Интернета (имегпег ргоюсо! а44гез$ сопиго!) и 
расширенное поле со списком (ежепае4 сотБо Бох сопиго). Все они использу- 
ются в примере ЕхО8Ь. Диалоговое окно ЕхО8Ь показано на рис. 8-2, к которому 
вам не раз придется обращаться в процессе работы. 


Максв, 2003 
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Рис. 8-2. Дополнительные стандартные элементы управления 
в диалоговом окне 
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Элемент выбора даты и времени 


Место для ввода даты и времени — типовое поле в диалоговых окнах. До того, как 
с выходом элементов управления 1Е4 появился стандартный элемент выбора даты 
и времени (4ме апа ите русКег), разработчикам приходилось использовать эле- 
менты управления сторонних поставщиков либо создавать подкласс МЕС-класса 
«поле ввода», где выполнялась значительная по объему проверка правильности 
введенной даты и времени. К счастью, новый элемент управления предоставляет 
пользователю массу возможностей при выборе даты и времени, а разработчику — 
обширную гамму стилей и параметров. Так, даты можно отображать в коротком 
(14.8.68) или длинном (14 августа 1968) форматах. Время можно вводить в хоро- 
шо знакомом пользователю формате «часы-минуты-секунды» с 12- или 24-часо- 
вым периодом. 

Данный элемент управления также позволяет вам решить, где пользователь будет 
указывать дату: в поле ввода, в календаре или в наборном счетчике. Среди других 
характеристик отметим возможность одиночного или множественного (для ука- 
зания диапазона дат) выбора и возможность включить/отключить обведение те- 
кущей даты красным кружком. Есть даже режим, позволяющий установить фла- 
жок «нет даты». На рис. 8-2 первые четыре элемента управления с левой стороны 
иллюстрируют различные конфигурации элемента выбора даты и времени. 

В МЕС класс СБшеТиптеСИ1 предоставляет МЕС-интерфейс к этому элементу 
управления. Класс поддерживает несколько уведомлений, расширяющих возмож- 
ности программирования элемента управления. Кроме того, в нем есть функции- 
члены для работы со структурами СТйте и СОершеТ те. 

Для установки даты и времени в СршеТитеСИ1 служит функция 5е!Гите, а для 
их получения — СеЙйте. Функция 5еЕогтаё позволяет задать собственные фор- 
маты отображения. 


Классы СТипе и СОераеТте 
Большинство программист ов, знак ых С 


ыкло, использовать т — 


° класса определяет 
‘приложения. 


Календарь на месяц 


Большое окно слева внизу на рис. 8-2 — это календарь на месяц (топ! саепааг). 
Подобно элементу выбора даты и времени, этот элемент управления позволяет 
выбрать дату. Однако его можно задействовать и для реализации небольшого лимч- 
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ного ежедневника (Регзопа! и!огтайоп Мапарег, РМ). Вы можете одновременно 
вывести столько месяцев, на сколько хватит места — от одного месяца до несколь- 
ких лет. В примере ЕхОЗЬ календарь показывает только два месяца. 

Данный элемент управления поддерживает одиночный и множественный вы- 
боры, а также позволяет выбрать различные параметры отображения, например, 
нумерацию месяцев или обведение кружочком текущего дня. Уведомления позво- 
ляют разработчику указать, какие даты выделить полужирным. Выбор того, что 
должны означать даты, выделенные полужирным начертанием, целиком и полно- 
стью предоставлен разработчику. Например, вы можете обозначить таким обра- 
зом праздники, назначенные встречи или свободные дни. В МЕС этот элемент 
управления реализован в классе СМои®СисиЛ. 

Для инициализации класса СМот Сас вызывается функция-член 5еПоаау. 
Функции этого класса, в том числе и $еоаау, могут работать как с СТиме, так и с 
СОершеТ те. 


Элемент ввода 1Р-адреса 


При разработке приложения, использующего в том или ином виде Интернет или 
ТСРЛЬ, иногда требуется запросить у пользователя 1Р-адрес. В состав стандартных 
элементов управления входит элемент ввода 1Р-адреса (ТР а@4гез$ сопто|, пока- 
занный на рис. 8-2 справа вверху. Кроме получения от пользователя 1Р-адреса, он 
автоматически проверяет корректность адреса. Поддержку элемента ввода ГР-ад- 
реса со стороны МЕС обеспечивает класс С/РАаагез$ С. 

Данный элемент управления состоит из четырех «полей», которые нумеруют- 
ся слева направо (рис. 8-23). 


Поле 0 Поле 1 Поле 2 Поле 3 


Рис. 8-3. Поля элемента ввода 1Р-адреса 


Этот элемент управления инициализируется вызовом функции-члена 5е!А4ате$ 
в функции Оттйов вашего диалогового окна. 5е{Адате5у получает в качестве 
параметра значение типа Р\/ОКЮ, в котором каждый байт соответствует одному 
полю. В обработчиках сообщений можно вызвать Сеаагезя для получения как 
РУ/ОБР, так и отдельных байтов, представляющих различные поля ТР-адреса. 


Расширенное поле со списком 


«Старомодное» поле со списком было разработано на заре \Апао\. Его «возраст» 
и негибкий дизайн создавали множество проблем. При выпуске элементов управ- 
ления Мсгозой решила включить в их число гораздо более гибкую версию поля 
со списком — расширенное поле со списком (ежепаеа сотБо Бох). 

Этот элемент управления облегчает разработчику доступ к полю редактиро- 
вания поля со списком и обеспечивает больший контроль над ним. Кроме того, к 
элементам списка можно присоединить список изображений (итазе 150). Вывод 
графических изображений в новом элементе управления довольно прост, особенно 
в сравнении с ранее применявшимися полями со списком с программной прори- 
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совкой (оупег-Агаула). Каждому элементу списка можно сопоставить три типа 
изображения: выделенное (звесе4 1итазе), невыделенное (ипзёесе4 итазе) и пе- 
рекрытое (оуейау итазе). Они позволяют получить различные виды вывода, что 
вы и увидите в примере ЕхО8Ь. Два расширенных поля со списком показаны вни- 
зу на рис. 8-2. МЕС-класс ССотроВохЕх полностью поддерживает расширенное поле 
со списком. 

Подобно «графическому списку» (см. выше), ССотфоВохЕх можно присоеди- 
нить к С/таве[1$, который в дальнейшем автоматически выводит графические изоб- 
ражения около текста в расширенном поле со списком. Если вы уже знакомы с 
ССотвВоВох, то ССотЬоВохЕх может вызвать замешательство: вместо строк в нем 
хранятся элементы типа СОМВОВОХЕХИПТЕМ — структуры, которая состоит из сле- 
дующих полей. 

Ш ОТ та$Ё — набор битовых флагов, определяющих, какие операции выпол- 
няются при помощи этой структуры. Например, если в результате операции 
устанавливается или должно быть получено поле изображения, устанавлива- 
ется флаг СВЕЕ /1МАСЕ. 

в ГУТ РТЕ Шет — номер элемента. Подобно обычному полю со списком, в рас- 
ширенном элементе управления нумерация начинается с 0. 

Ш ГР5ТК р52ТехЕ — текст элемента. 

Ш пи ссьТежМах — длина буфера, на который указывает р2Техр. 

Ш 1 Итазе — порядковый номер (начиная с нуля) в присоединенном списке 
изображений. 

Ш ии бее<ейГтаве — порядковый номер (начиная с 0) в присоединенном списке 
изображений, который используется для представления «выбранного» состояния. 

Ш 121 ЮзеЧау — порядковый номер (начиная с 0) в присоединенном списке 
изображений, который служит для перекрытия текущего изображения. 

Ш #211 ИпаепЕ — число 10-пиксельных отступов. 

Ш ГРАКАМ [Рагат — 32-разрядный произвольный параметр, связанный с эле- 
ментом. 


Вы увидите, как использовать эту структуру, в примере ЕхО8Ь. 


Пример Ех08Ь: Дополнительные 
стандартные элементы управления 


Мы построим диалоговое окно, в котором создадим и запрограммируем допол- 

нительные стандартные элементы управления всех типов. 

1. Запустите МЕС АррНсаНоп У/12агд и создайте проект Ех08Ъ. Выберите в 
меню ЕЙе последовательно команды № у и Рго]есе. В диалоговом окне М№е\ 
Рго]ес{ качестве типа приложения выберите МЕС АррИсанНоп и в качестве име- 
ни проекта — ЕхО8Ь. На странице АррИсаНоп Туре мастера установите пере- 
ключатель в положение Зпе Чоситепь, оставив остальные параметры без 
изменения. 


' Только при наличии текста элемента. — Прим. перев. 
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2. Создайте новый ресурс диалогового окна с идентификатором ШО _П/А- 
ТОСТ. Выберите в меню Рго}еси среды разработки команду Аа КВезоигсе и со- 
здайте новый диалоговый ресурс. Разместите элементы управления в диалого- 
вом окне с помощью окна Тоорох. (Если его не видно, выберите в меню У1е\ 
команду Тоо!рох.) В таблице показан список элементов управления, их иден- 
тификаторы и порядок обхода. После определения свойств СарНоп статичес- 
кого текста в диалоговом окне должны быть следующие элементы управления 
и порядок обхода. 


РеБгиагу, 2092 


Тие \еЧ Ту РИ 


5уп_Моп_Тиуе \/ед ТВи 
М ^.- а 1 


1314 15 6 


Эа 

з 2 
уч. 9 4 42$ 
6 

23 


20 21 22.23 
27 28 29 30 


21 ® 


Однако пока не установлены некоторые свойства, наше диалоговое окно не 
будет выглядеть в точности, как на рис. 8-2. 


Идентификатор Последовательность 

Тип элемента управления дочернего окна при нажатии Таь 
Группирующая рамка ШРС 5ТАПС 1 

Статический текст ШРС _5$ТАПС 2 

Элемент выбора даты/времени РС _РАТЕПМЕР!СКЕК1 3 

Статический текст ШРС _5ТАТС1 4 

Статический текст РС $ТАПС 5 

Элемент выбора даты/времени РС _РАТЕПМЕРСКЕК2 6 

Статический текст ШС _5$ТАГС2 7 

Статический текст РС $ТАПС 8 

Элемент выбора даты/времени Ш2С_РАТЕПМЕР!СКЕКЗ 9 

Статический текст РС _5ТАГИСЗ 10 

Статический текст ШС 5ТАПС 11 

Элемент выбора даты/времени ШС _РАТЕПМЕРСКЕК4 12 

Статический текст РС _5$ТАПСА 15 

Статический текст ШС 5ТАПС 14 

Календарь на месяц Ш)РС_МОМТНСАГЕМРАК1 15 

Статический текст ШРС _5ТАТС5 16 
Группирующая рамка ОС $ТАПС 17 


см. след. стр. 
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Идентификатор Последовательность 
Тип элемента управления дочернего окна при нажатии ТаБ 
Статический текст С _5ТАПС 18 
Элемент ввода адреса Интернета РС 1РАРОКЕ$ $ 1 19 
Статический текст ШС 5ТАГСб 20 
Группирующая рамка РС _$ТАПС 21 
Статический текст ШС _5ТАПС 22 
Расширенное поле со списком Ш)С_СОМВОВОХЕХ1 23 
Статический текст Ш)С_5ТАПС7 24 
Статический текст ШС 5$ТАПС 22 
Расширенное поле со списком Ш)С_СОМВОВОХЕХ2 26 
Статический текст Ш)С_5ТАТ!С8 27 
Кнопка ШОК 28 
Кнопка ТРСАМСЕЕ 29 


Используйте МЕС (1а$$ \/Л1таг4 для создания нового класса СЕХОЗЬЮ1 05, 
производного от СОйщоз. Выберите класс в С!а$5 У1е\,, а затем —команду Ааа 
С!а$$ в меню Рго}есе. В окне МЕС С!а3$ УЛтага в качестве базового выберите класс 
СРамщов, а в поле со списком Гаю Ш — ШО ГАГОС1: 


МЕС С1а5$ \Игагд - Ех086 


\умесоте {о {Пе МЕС С1а5$ \Игага 


ТН& уйзагд а945 а Ча5$ Ва пНейе$ гот МЕС Ко уошг ргодесЕ, Орбопз тау сРапде дереппа 
оп Ве Базе с1а55 зае(ед. 


Переопределите функцию ОпмйДйов. Выберите класс СЕхОЗЬГ08 в С!а$$ 
\У!е\. Щелкните кнопку Оуегиае$ в верней части окна Ргорегие$ и добавьте 
функцию ОттйОйщов. 

Настройте свойства элементов управления в диалоговом окне. Чтобы 

продемонстрировать все разнообразие элементов управления, нам нужно ус- 

тановить свойства каждого из стандартных элементов управления. 

О Элемент выбора даты и времени в коротком формате. В первом эле- 
менте выбора даты и времени (ШС _РАТЕПМЕРСКЕК1) убедитесь, что уста- 
новлен короткий формат даты (по умолчанию): свойству Еогтае задано 
значение 5Вог Рае. 

С Элемент выбора даты и времени в длинном формате. Второй элемент 
выбора даты и времени (ШС РАТЕПМЕР!СКЕК2) настройте на длинный 
формат, задав значение Гопз Оже свойству Еогтае. 
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О Элемент выбора даты и времени в коротком формате с дополнитель- 
ными возможностями. В третьем элементе выбора даты и времени 
(1Ш2С_РАТЕПМЕРСКЕЕЗ) задайте значение Вог Рае свойству Еогплаь, а 
свойствам АПо\у Еай, ЗВоу/ Мопе и 0$е $рш Сопио! — ТВОЕ. 

С Элемент выбора времени. Четвертый элемент выбора даты и времени 
(12С_РАТЕПМЕР/СКЕК4) настройте для выбора времени, а не даты. Для этого 
свойству Еогтпа( присвойте значениеТите, а свойству 0зе Зр Сопио! — ТВОЕ. 

С Календарь на месяц. Сначала свойству Рау $1а(е$ задайте ТКОЕ. Кроме того, 
по умолчанию календарь в диалоговом окне вообще выглядит не так, как 
элемент управления — у него нет обрамления. Чтобы он был похож на дру- 
гие, установите свойства СПепе Едэе и 5айс Е4се в ТКОЕ. 

С Элемент ввода ГР-адреса. У этого элемента управления (12С_1РАРОКЕ$$ 1) 
никаких свойств менять не нужно. 

О Расширенные поля со списком. У этих элементов управления (2С_СОМ- 
ВОВОХЕХ1 и РС_СОМВОВОХЕХ2) свойств менять не нужно. 

. Добавьте переменные в класс СЕХОЗЬ 1/02. Запустите АА Мепьег УамаЫе 

УЛгага, выбрав класс СЕхОЗЬОй ов в окне С1а3$ У1еу,, а затем щелкнув команду 

Ааа УанаЫе в меню Рго}ес!. Для каждого элемента управления создайте соот- 

ветствующую переменную из таблицы. 


Идентификатор Категория Тип Имя переменной 

12С_РАТЕПМЕР!СКЕВ1 Элемент управления СрееПтес  т_МотрсаИ 
(Сопго!) 

12С_РАТЕТМЕР!СКЕВ2 Элемент управления среиеПтест — т_Мот№Са2 
(Сопиго!) 

Ш2С_РАТЕТ!МЕРСКЕВЗ Элемент управления сраеГтесС  т_МошрСаЗ 
(Сопиго!) 

ГОС _РАТЕТМЕР!СКЕК4 Элемент управления сраеГтеб  т_МотфСа“ 
(Сопиго[) 

ШОС 1РАРОВЕЗ$$ 1 Элемент управления СРАаагез СИТ т РИРОШ 
(Сопо1) 

1Ш2С_МОМТНСАГЕМРАВ1 Элемент управления СМотрсаст — т _МотрСа5 
(Сопио!) 

ШС $ТАГС1 Переменная (Уае) Суттия т $ирше1 

ШС _$ТАГ!С2 Переменная (Уаше) Суття т 5йрше2 

ШОС $ТАТ!С5 Переменная (Уае) Стив т и7реише3 

ШС _$ТАТГ!С4 Переменная (Уаще) Сутия т 5йирише4 

ШС $ТАТЮ5 Переменная (Уаае) Стив т ятрщеб 

12С_$ТАТ!Об Переменная (Уаще) Суття т _5РИжие 

ШС _5ТАТС7 Переменная (Уаще) Суттв т_я"СотроЕх1 

ШОС _$ТАТ!С8 Переменная (Уаще) Суттв т_;"СотВроЕх2 


Запрограммируйте элемент выбора даты/времени в сокращенном 
формате. В данном примере нас не интересует начальная дата, отображаемая 
в элементе управления, поэтому мы не обрабатываем его в ОпйтиП ов. Если 
же необходимо задать дату, придется в ОпйтйОйжов вызвать метод 5е Гёте. Кроме 
того, когда во время выполнения пользователь выбирает новую дату, связан- 
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ный статический элемент управления должен автоматически обновляться. Для 
этого нужно позаботиться об обработчике сообщения ОТМ№ РАТЕПМЕСНАМОАЕ. 
Выберите класс СЕхОЗЬ0\еов в С1а5$ УМле\, щелкните кнопку Еуеп($ в окне 
Ргорегие$, разверните узел /2С_ДАТЕТИМЕР/СКЕК1, выберите сообщение О27М№_ЛА- 
ТЕПИМЕСНАМСЕ и создайте обработчик ОпртОшщейтесвапвержщейтерсве!1. 
Затем добавьте в обработчик для элемента управления Оаиейтер!сКег1 следу- 
ющий код: 


\0149 СЕх08601а109: : Оп0{пбате{1теспапдеВате{1тер1скег1 (ММНОВ» рММНОВ 
Е ВЕЗИЕТя рНези11) 
{ 
{РАМОАТЕТТМЕСНАМСЕ рОТСпапде = 
ге1птегрге{ _сазт<ЕРММОАТЕТТМЕСНАМСЕ> ( РАМНОВ) 
СТ1те ст; 
п_МопЕНСа11. бетт1те( ст); 
т_$з1гбате1. Рогтат(_Т("%029/%029/%24"), 
ст. бетМопеВ(), се. бетБау(), ст. бет\еаг()); 
Ордатерата(РАЕЗЕ); : 
*рНези1т = 0; 


В этом коде для записи значения времени в переменную с! типа СТйте при- 
меняется переменная-член т_МотшСаИ, соответствующая первому элементу 
выбора даты/времени. Затем функцией С5#тр::Еоттай устанавливается текст 
соответствующего статического элемента управления. Наконец, с помощью 
Прашереийая(ЕАГЗЕ) запускается ООХ МЕС и вызывается автоматическое обнов- 
ление статического элемента управления. 


Запрограммируйте элемент выбора даты/времени в ‹длинном>» формате. 
Создадим аналогичный обработчик для второго элемента выбора даты/времени. 


\019 СЕх08601а109: : ОпО&пбаке{1теспапдебате1терускег2 (ММНОВ» рАМНОВ, 
| ВЕЗИЁТ* рНези1*) 
{ 
| РММОАТЕТТМЕСНАМОЕ рОТСпапде = 
ге1птегрге{ _саз+<ЕРММОАТЕТТМЕСНАМОЕ> ( рММНОВ) ; 
СТ1те ст; 
т_МопЕИСа12. бетТ1те( ст); 
м_з+гОате2. Рогта*(_Т("%029/%029/%29”), 
ст. бе{Мопеп(), се. бе{бау(), с+. бетУеаг( ).) 
Урдатерата(РАЕЗЕ); 
«рНези11{ = 0; 
} 


Запрограммируйте третий элемент выбора даты/времени. Для этого 
нужен аналогичный обработчик, но, поскольку мы установили в его свойствах 
флаг Зпо\/ Мопе, пользователь может задать «недействительную» (МОТ) дату, 
щелкнув встроенный флажок. Вместо вызова Се ийте «вслепую» мы должны 
проверить возвращаемое значение. Если оно не нулевое, то пользователь выбрал 
МОИ -дату, в противном случае — допустимую дату. Как и в двух предыдущих 
обработчиках, значение объекта СТйте преобразуется в строку и автоматически 
отображается в соответствующем статическом элементе управления: 
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\0149 СЕх08601а109: : ОпОЕпбате1теспапдебате{1тер1сКег3 (ММНОВх РММНОВ, 


{ 


} 


ЕВЕЗУЁТ» рВези1+) 


ЕРАМБАТЕТТМЕСНАМСЕ рОТСвапде = 
ге1птегрге{_сазт<ЕРММОАТЕТТМЕСНАМОЕ> ( рАМНОВ): 
// ВНИМАНИЕ: может иметь значение МЕ 
СТ1те ст; 
1п{ пВеф\а1 = м_МопЕВСа13. беТ1те(с+); 
11 (пАеф\а1) // Если это не 0, то пи11; 
// а если это так, делайте то, что следует. 
{ 
п_з{гОате3з = "№0 БАТЕ ЗРЕСТЕТЕО!!"; // Дата не указана 
} 
е1зе 
{ 
п_3+гОатезЗ. Рогта*(_Т("%029/%0249/%24"), с. беёМопН(), 
ст. бетбау(), сф. бефУеаг()); 
} 
Урдатедата( РАТЗЕ); 
*рНези1{ = 0; 


9. Запрограммируйте элемент ввода времени. Для элемента ввода времени 
нужен аналогичный обработчик, но формат вывода вместо «месяцы/дни/годы» 
будет «часы/минуты/секунды»: 


\у014 СЕх08601а109 : : ОпОтпбате{1теспапдебатет1тер1скега (ММНОВ* РММНОВ, 


{ 


} 


ЕВЕЗИЕТ» рВези1+) 


ЕРАМОАТЕТТМЕСНАМСЕ рОТСвапде = 

ге1птегргет_сазт<ЕРММОАТЕТТМЕСНАМОЕ> ( РММНОВ) ; 
СТ1те ст; 
п_МопПСа14. бееТ1те( ст); 
т_3{гОате4. Рогта* (_Т("%024: #024: %24"), 

СЕ. бефНоиг(), с+. беЕМ1пите(), с+. бетЗесопа()); 

Ордатебата( РАЕЗЕ); 
*рВези1т = 0; 


10. Запрограммируйте календарь на месяц. Обработчик для календаря похож 
на обработчик для элемента выбора даты/времени, но между ними есть и раз- 
личия. Во-первых, чтобы определить смену даты пользователем, нужно обра- 
батывать сообщение МСМ 5ЕГСНАМСЕ. Выберите класс СЕХОЗЬРщов в Са5$ У1еуу, 
щелкните кнопку Еусп($ в окне Ргорегиез, разверните узел /2С_МОМТНСАГЕМ- 
РЕК1, выберите сообщение МСМ $ЕГСНАМСЕ и создайте обработчик ОиМси$е/- 
сфапвеМотрсиепает1. Помимо другого имени обработчика, в этом элементе 
управления применяется функция СеСит$е, а не СеТите. Вот обработчик 
МСМ_5ЕГСНАМСЕ для элемента управления «календарь на месяц»: 


\019 СЕх08001а109 : : ОпМсп$е1 спапдемоппса1епдаг1 (ММНОВ* РММНОВ, 


{ 


-ВЕЗУЕТ» рВези1т) 
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| Р№ЗЕЕСНАЮЕ р5е1Спапде = 
ге1пфегрге{_сазт<ЕРММ$ЕЕСНАМВЕ> ( рММНОВ) ; 
СТ1те ст; 
т_МопЕИСа15. бе{Сиг$е1 (с{); 
п_$+гОафе5. Рогтат(_Т("%029/%029/%24"), 
к Ст. беЕМопеп(), с+. бе{бау()), ст. бетУеаг()); 
Ордатебата(РАЕЗЕ); 
*рНези11{ = 0; 
} 


11.Запрограммируйте элемент ввода ГР-адреса. Сначала нужно убедиться, что 
элемент управления инициализирован. Для этого мы передаем ему значение 0 
типа ОХОБВО. Если не выполнить инициализацию, все без исключения поля 
элемента управления будут пустыми. Добавьте в СО&/081::Отт 08 ВЫЗОВ: 


// Инициализация элемента ввода адреса Интернета 
т_рЕГТРСЕг1 . Зе+Адагез$ (01); 


Теперь нам нужен обработчик сообщения для обновления связанного ста- 
тического элемента управления при всяком изменении ГР-адреса. Выберите 
класс СЕхОЗЬО ов в С!а55 У1еуу, щелкните кнопку Еуеп($ в окне Ргорегие$, раз- 
верните узел 12С 1РАРОКЕ$5 1, выберите сообщение /Р№М_МЕГРОСНАМСЕР и со- 
здайте обработчик ОтриНеасрапвейрааагез$1. 

А затем реализуем обработчик следующим образом: 


\0149 СЕхО8Ь01а109: : ОпТри-1е1аспапдедТрадагез$1 ( ММНОВ* рАМНОВ 
| ВЕЗУТ» рВези1+) 
{ 
{РММТРАООВЕ$$ рТРАдаг = 
ге1птегргет_сазе<ЕРАМТАООВЕЗ$$> ( рАМНОВ) ; 
ОМОВО дмТРАФдгез$; 
п_рЕгТРСЕг1 . бетАЧ9гезз ( дмТРАЧ@гезз); 


м_3+гТР\а1ие. Рогта*("%4.%9.%4.%а — #%х.#%х.Хх.%х", 
НТВУТЕ( НТМОВО( амТРАддгезз)), 
[ОВУТЕ( НТМОВО( 9мТРАддгез$)), 
НТВУТЕ( 1 О0МОВО( 9мТРАддгезз) ), 
Г ОВУТЕ(ЕОМОВО( дмТРАдагез3$))), 
НТВУТЕ( НТМОВО( дмТРАд9дгезз)), 
1ОВУТЕ(НТМОВО( дмТРАЧаге$$)), 
НТВУТЕ( 1 О0МОВО( 9мТРАФ@гезз) ), 
| ОВУТЕ( ГОМОВО( 9мТРАФдгезз))); 

Ордатебата(РАЕЗЕ); 

«рВези11{ = 0; 


Вызов С/РАаагез;С::дейаате55 помещает 1Р-адрес в локальную переменную 
ЯиЛРАаагезх типа РУ’ОКО. Далее следует довольно сложный вызов С5#ив::Еоттей, 
разделяющий РУОКР на отдельные поля. Здесь применяется макрос [ГОУОКР 
для получения младшего слова, макрос НПУОКР для получения старшего сло- 
ва и макросы ШВУТЕ/ОВУТЕ для выделения отдельных полей. 


176 Часть ! Основы МЕС 
— 


12. Добавьте элементы списка для первого расширенного поля со списком. 
Допишите следующий код, чтобы добавить программно элементы «Сеогое» 
«бапау» и «Теаау» в первое расширенное поле со списком. Заметили ли вы раз- 
ницу между этим и обычным полем со списком? 


// Инициализация ТОС_СОМВОВОХЕХ1 
ССотбоВохЕх* рСотбо1 = 
(ССотроВохЕх* ) бет01911ет( ТОС_СОМВОВОХЕХ1): 
С$1г1п9 гдзфгТетр1[3]; 
гозЕгТетр1[0] = “беогде”; 
гозгТетр1[1] “бапау”; 
гдз{гТетр1[ 2] "Тедду"; 


СОМВОВОХЕХТТЕМ с611 
с611.тазк = СВЕТЕ _ТЕХТ; 
Гог (11 пбоипЕ = 0; пбоипт < 3; пбоип++) 
{ 
©6011. 1Т+ет = пСоип*; 
©6011. рз2Техе = (ЕРТЗТВ) (ЕРСТЭТВ) гдз гТетр1 [пСоипЕ] 
©611. сспТех{Мах = 256: 
рСотро1->ТпзегЕТ4ет( &с511): 


Первое, что бросается в глаза, — использование структуры СОМВОВОХЕХТЕМ 
вместо простых целых чисел в предыдущих версиях этого элемента управления. 


13. Добавьте обработчик для первого расширенного поля со списком. Нам 
нужен обработчик сообщения СВМ_$ЕГСНАМСЕ от первого поля со списком. 
Выберите класс СЕхОЗЬР ов в С!аз$ Улеу, щелкните кнопку Еуеп{$ в окне 
Ргорегчез, разверните узел ([2С_СОМВОВОХИ, выберите сообщение СВМ $Е[- 
СНАМСЕ и создайте обработчик Опсьи5есрапзеСотвофохех1. Вот измененный 
код обработчика поля со списком. 


у019 СЕх08601а109: :ОпСЬп5е1спапдеСотьорохех1 () 
{ 
СОМВОВОХЕХТТЕМ сБ1; 
С$4г1п9 зЁг ("Читту_3г1п9"); // просто строка 
ССотроВохЕх * рСотбо = (ССотроВохЕх * )бе1019Т+ет( ТОС_СОМВОВОХЕХ1); 


1пЕ п5е1 = рСотБо->бетСиг$е1(); 
с61.1Т{ет = п5е1; 

с61.рз2Техе = (ЕРТЗТЯ) (ЕРСТУТВ)з{г; 
с61.тазк = СВЕТЕ_ТЕХТ; 

с61. ссНТехЕМах = з{г. бетЁепдеп(); 
рСотро->беТ4ет( &с61); 
$е+0191+етТех{ (Т0С_ЗТАТТСТ, з1г); 
гетигп; 


Получив описание элемента, обработчик извлекает строку и вызывает 5е//е- 
Пет1Тех1 для обновления связанного статического элемента управления. 
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14. Добавьте изображения к элементам второго расширенного поля со 
списком. Первое поле со списком не требует специального программирова- 
ния. Оно просто демонстрирует, как реализовать простое, похожее на «обыч- 
ное» расширенное поле со списком. Но для второго поля со списком потребу- 
ется довольно много программировать. Сначала нужно раздобыть 6 растровых 
изображений и 8 значков и добавить их в ресурсы проекта. Вы вправе взять 
их с компакт-диска или любые другие, имеющиеся под рукой. Добавьте эти 
растры и значки в Везочгсе У1е\у и задайте их идентификаторы, как показано 
на рисунке. 


3 Ассеегаког 
ВЕгпар 

2 1ОВ_ВМЕВО 
10В_ВМЕВОЗЕЦЕСТЕВ 
ТОВ_ВМО0б 
108_ВМРОСЗЕТЕСТЕО 
ТОВ_ВМЕ5Н 
ТОВ_ВМЕТЗН$ЕТЕСТЕВ 


ТО1_СВЕЕМ 
ТО1_РИВРЕЕ 


101 ВЕС 

3 Е МНПЕ 

ТО УЕЦОМ 
[3] 108. ЕхОВЬТУРЕ 
{ 108_МАМЕВАМЕ 


Прежде чем добавлять изображения к расширенному полю со списком, 
создадим в классе СЕхОЗ60 408 открытую переменную-член 7 йпаве[415 типа 
Стазе $. Добавьте в заголовочный файл ЕхО8ЬП1а1о2.В строку: 


СТтадеЕ1$1 м_1тадее1$т; 


Теперь мы можем добавить к списку изображений несколько растров и за- 
тем «связать» изображения с тремя элементами, добавленным в расширенное 
поле со списком. Добавьте в метод ОйтйОйжщов класса СЕХОЗЬГ1 ов такой код: 


// Инициализация ТОС_СОМВОВОХЕХ2 
ССотбоВохЕх* рСотбо2 = 
(ССотроВохЕх*) бе+0191Т+ет(ТОС_СОМВОВОХЕХ2); 
// Сначала добавим изображения к элементам. 
// У нас 6 растров, которые мы сопоставим нашим строкам: 


т_1тадеЕ1$+. Сгеате(32, 16, ТЕС_МАЗК, 12,4); 
СВ1ттар 611мтар; 
01 (тар. Гоа9В1{мар(ТОВ_ВМВТВО); 


т_1тадеЕ15{. Ада (&61{тар, (СОГОВВЕР)ОхЕЕЕЕЕЕ); 
61 1тар. Ое1етео6]ест(); 
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51 {тар. Гоа9В1{тар( ТОВ. ВМВТАОЗЕЕЕСТЕО); 
т_1тадеЕ15{. Ада (&61+тар, (СОЕОВВЕЕ)ОхЕЕЕЕЕЕ); т 
1 (тар. Белетео6]ест(); 


611тар. ГоааВ1 {тар (ТОВ_ВМО0б); 
п_1тадее131. Ада (&61+тар, (СОГОВВЕР)ОХЕЕЕЕЕР):; 
о1{тар. Бе1ете06]ест(); 


61{тар. ГоадВ1тар(ТОВ_ВМООСЗЕЕЕСТЕО); 
п_1тадеЕ1$+. Ада ( &611тар, (СОГОВВЕЕ)ОхХЕЕЕЕЕЕ) 
61{тар. Ое1етео6ес*(); 


61{тар. ГоадВ1{тар( ТОВ_ВМЕТЗН): 
п_1тадее13т. Ааа ( &611тар, (СОГОВВЕЕ)ОхХЕЕЕЕЕЕ) 
1 тар. Ве1ете06]ес+() 


61 {тар. ГоадВ1{тар(ТОВ_ВМЕТЗНЗЕЕЕСТЕО); 
т_1тадег15т.А94(&614тар, (СОГОВВЕЕ)ОхХЕЕЕЕЕЕ) 
Ь1{тар. Ве1етед6)ест(): 


// Определяем список изображений 
рСотро2->5е1ТтадеЕ1 1 (&м_1тадеЕ1з+): 


С$4г1п9 гдзфгТетр2[3]; 
газфгТетр2[0] = "Тмеету"; 
гозфгТетр2[1] = “Маск”; 
гозгТетр2[2] = “ам”; 


СОМВОВОХЕХТТЕМ с612; 
с612.тазк = СВЕТЕ_ТЕХТ! СВЕТЕ _ТМАСЕ! СВЕТЕ _ЗЕТЕСТЕОТМАСЕ! СВЕТЕ_ТМОЕМТ; 
11 пВ1марСоип{ = 0; 
Рог (11 пбоипЕ = 0; пбоипе < 3; пСоип++) 
{ 
с6012.1Т+ет = пСоип*: 
с612. рз2Тех{ = (ЕРТЭТН) (ЕРСТЭТВ) гдз гТетр2 [ пбоип{] 
612. сспТех{Мах = 256; 
©612.1Ттаде = пВ1Ттарбоипт++; 
с612. 15е1естедТтаде = пВ1{тарСоип*++; 
с612.1Тпаепе = (пбоипе & 0х03); 
рСотро2->ТпзегЕТ1ет( &с612); 


Сначала, используя Сей1юПет, получаем указатель на элемент управления. 
Затем вызываем Стеше для выделения памяти под изображения и инициали- 
зации списка изображений. Следующая серия вызовов загружает каждое рас- 
тровое изображение, добавляет его в список изображений и удаляет ресурс, 
выделенный при загрузке. 

Для привязки 7т_йтаве!1$1 к расширенному полю со списком вызывается 
ССотфоВохЕх::5еЙтаве!4я1. Далее инициализируется структура СОМВОВОХЕХ!1- 
ТЕМ, и в цикле /от от 0 до 2 для каждого элемента устанавливаются изображе- 
ния в выбранном и невыбранном состоянии. Создается массив строк 785 1етр, 
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связанный с каждым изображением и состоящий из трех элементов: «Тууеегу», 
«Маск» и «]а\у5». Переменная иВйтарСоип служит для настройки строки поля 
со списком, она также задает идентификатор растрового изображения, поме- 
щаемый в структуру СОМВОВОХЕХТЕМ. В теле цикла сначала вызывается ССот- 
роВохЕх::деШет, чтобы получить сведения о каждом элементе расширенного 
поля со списком. Затем для элемента задаются растровые изображения, и вы- 
зывается ССотбоВохЕх::5еет для передачи измененной структуры СОМВОВОХ- 
ЕХПТЕМ обратно в список и завершения связывания изображений с существу- 
ющими элементами списка. 


15.Добавьте элементы во второй расширенное поле со списком. Другой 
способ размещения изображений в расширенном поле со списком — добавить 
их динамически, как показано в коде, добавленном в ОйийБйов: 


НТСОМ ПТсоп[8] 
111 п; 
// Теперь добавим несколько цветных значков 
ПТсоп[0] = АЁх@етАрр()->ЕГоа9Тсоп(ТОТ_МНТТЕ); 
пТсоп[1] = АРхбетАрр()->ЕГоаа9Тсоп(ТОТ_ВЕАСК): 
ЮТсоп[2] = АЁхбетАрр()->1оа9Тсоп(ТОТ_ВЕО); 
пТсоп[3] = АЁхбетАрр( )->1оа9Тсоп( ТОТ_ВЕШЕ); 
пТсоп[4] = АгхбетАрр()->ГоадТсоп( ТОТ_УЕЕЕОМ); 
ВТсоп[5] = АЁхбетАрр()->1оа9Тсоп( ТОТ_СУАМ); 
АТсоп[6] = АЁхбетАрр( )->1оа9Тсоп( ТОТ_РИУВРИЕ); 
ВТсоп[7] = АРхбетАрр()->ГоадТсоп( ТОТ_СВЕЕМ); 
Рог (п=0; п < 8; п++) { 

м_1тадеЕ1$т. Ад9(ИТсоп[п]); 
} 


Зфаф1с спаг» со1ог[] = {"ип1 фе”, “Б1аск”, “гед”, 
"Б1ие”, “уе11ом", “суап”, 
"“ригр1е”, “дгееп“}; 


с612.тазк = СВЕТЕ_ТМАСЕ! СВЕТЕ_ТЕХТ!СВЕТЕ_ОМЕВЬАУ! 
СВЕТЕ_ЗЕГЕСТЕОТМАСЕ; 


Рог ‘(п =0; п < 8: п++) { 
©6012. 11Чет = п; 
612. рз2Тех& = со1ог[п] 
с612. 1Ттаде = п+6б; // 6 - это смещение в списке изображений 
с012.15е1естедТтаде = п+6; // на 6 уже добавленных элементов. . 
с612.10\уег1ау = п+6; 
11 пет = рСотбо2->Тпзег+Т{ет( &сЬ12); 
АЗЗЕВТ (пТфет == п); 


Добавление значков в вышеприведенном коде напоминает пример ЕхО8а. 

В цикле /ог заполняется структура СОМВОВОХЕХИТЕМ, а затем вызывается ССот- 
роВохЕх:1п5еШет для добавления отдельных элементов. 

16. Добавьте обработчик для второго расширенного поля со списком. Вы- 

берите класс СЕхОЗЫО в в С1а5$ У1еуу, щелкните кнопку Еуеп($ в окне Ргорегиез, 
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разверните узел П2С_СОМВОВОХ2, выберите сообщение СВМ $ЕЕСНАМСЕ и 
создайте обработчик ОпсрибесраивеСотвовБохех2. Добавьте выделенный код — 
это в сущности тот же обработчик, что и для первого поля со списком: 


у014 СЕхО8001а109 : :ОпСЬп5$е1спапдеСотробохех2 () 

{ 
СОМВОВОХЕХТТЕМ сБ1; 
С51г1п9 зг ("аитту_$4г1п9"); // просто строка 
ССотроВохЕх * рбомбо = (ССотЬоВохЕХ *)бе+019Т+ет(ТОС_СОМВОВОХЕХ2): 
1пЕ п$е1 = рСотБо->беСиг$е1(); 
с61.1Т+ет = п5е1; 
с61.рз2Техф = (ЕРТЗТВ) (ЕРСТУТВ)з+г; 
с61.тазк = СВЕТЕ_ТЕХТ; 
©61. ссНТехЕМах = з{г. бетЁепдеп() 
рСотро->бетТ+ет( &сЬ1); 
$е10191Т+етТех+(ТОС_ЗТАТТС8, $1г); 
гетигп; 

} 


17. Свяжите диалоговое окно с классом «вид». Добавьте следующий код в вир- 


туальную функцию Опртгаш в файле ЕхО8Ь\1еуусрр. Выделенный код заменяет 
имеющийся: 


у019 СЕхОЗЬ\1ем: :Оп0гам(С0С* роб) 

{ 
СЕхО8\бос» рбос = бетбоситеп{(): 
АЗЗЕВТ_МАСТО(р0ос):; 


роб->Тех{0и{(0, 0, “Ргезз пе 1еРЕ тоизе Биффоп Неге. ") 
} 


18. Добавьте функцию-член ОшШВинопроип к классу СЕхО8ЬИеи,. Выбери- 
те класс СЕхОЗЬ 08 в С1а5$ У1еуу, щелкните кнопку Меззазе$ в окне Ргорегис$, 
выберите сообщение ИМ _ГВИТТОМРО\УМ и создайте обработчик От[ВиНопроил. 
Отредактируйте код таким образом: 


У014 СЕхОва\1ем: : ОпЕВиЕопбомп(ИТМТ пЕ1адз, СРо1пЕ ро1п+) 
{ 

СЕх08501а109 919; 

919.00Мода1(); 


С\У1ем: :ОпЕВиопбомп(пЕ1адз, ро1п+); 
} 


Добавьте следующий оператор в файл ЕхОЗЬ\1е\усрр, чтобы включить в него 
заголовочный файл ЕхО8ЬПаю5.П: 


#1пс1и49е ”Ех08601а109. п” 
19. Соберите и запустите программу. Теперь вы можете поэкспериментировать 


со стандартными элементами управления, чтобы увидеть их в работе И ПОНЯТЬ, 
насколько они годятся для ваших приложений. 


ГЛАВА 


Использование элементов 
управления АсНуех 


Разирти всегда искали пути «компонентизации» элементов пользователь- 
ского интерфейса. Хотя в М1сгозой УЛп9о\у$ много встроенных элементов управ- 
ления, таких как кнопки или поля ввода, было бы неплохо иметь и другие эле- 
менты управления, скажем, диаграммы или таблицы. В «классической» разработ- 
ке в среде УЛю9о\$ эта проблема решается созданием элементов управления АспуеХ 
(раньше их называли ОГЕ сопго|5 или ОСХ). Элементы управления АспуехХ дос- 
тупны как в М!сгозой У15ча! Вас, так и в М1сгозой У15ча! С++. 

Даже с появлением М!сгозой МЕТ элементы АсИУеХ не стали менее важны. В этой 
главе речь пойдет о применении АсНуеХ-элементов в приложениях \15ча1 С++ МЕТ. 
Предполагается, что вы сможете научиться их использовать, даже ие имея особых 
знаний о лежащей в их основе модели СОМ, — в конце концов М!сгозой не тре- 
бует, чтобы программисты на УВ были экспертами по СОМ. Но, чтобы уметь пи- 
сать элементы управления АсИуех, вам потребуется немного больше, в первую оче- 
редь знание фундаментальных основ СОМ. В главах 22-28 мы детально расска- 
жем о СОМ, а также о применении АТИ, для создания элементов управления Асйуех. 
Если вы всерьез настроены создавать такие элементы управления, отсылаем вас 
к книге Адама Деннинга (Адат Репп!п$) «АсиуеХ Соп!го!5 шае Очь (Мсгозой 
Ргезз, 1997). Но, конечно, осведомленность в каких-то вопросах теории элемен- 
тов управления АсйуеХ не повредит, когда вы будете использовать их в своих 
программах. Основы, с которых можно начать, вы найдете в этой книге в главах 24, 
25 и 30. Даже в мире М1сгозой МЕТ технологии АсИуеХ найдется место для созда- 
ния гибких компонентных прикладных пользовательских интерфейсов. 
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АсНуеХ и обычные элементы управления МИпаом$ 


Элемент управления АсйуеХ — это программный модуль, подключаемый к про- 
граммс так же, как и элемент управления УЛп4оуу5. По крайней мере так кажется. 
Сравним элементы АсЦУеХ и уже известные нам элементы управления УЛпаоуу5. 


Основные характеристики обычных элементов управления 


В главе 8 мы применяли обычные элементы управления УЛп4о\5, такие как поля 
ввода и списки, и познакомились со стандартными элементами управления УЛ п- 
Чоу, которые работают в целом аналогично. Все они представляют собой дочерние 
окна и применяются главным образом в диалоговых окнах — для их представле- 
ния в МЕС служат классы, такие как СЕЯй и СТуееС, За создание дочернего окна 
элемента управления всегда отвечает клиентская программа. 

Обычные элементы управления посылают диалоговому окну уведомления (стан- 
дартные \Л1паоууз-сообщения), например ВМ СИСКЕР. Если вы хотите что-то сде- 
лать с элементом управления, вы вызываете функцию-член соответствующего 
класса С++, которая передает этому элементу \Ипао%и-сообщение. Все элементы 
управления по своей природе — окна. МЕС-классы для элементов управления яв- 
ляются производными от класса Спа, поэтому, чтобы получить текст из поля ввода, 
вы обращаетесь к С\иа::Сей/таошТехт. Но работа и этой функции строится на 
передаче сообщения элементу управления. 

Элементы управления \Лпао\з — неотъемлемая часть этой ОС, хотя стандар- 
тные элементы управления УЛп4о\$ и находятся в отдельном РИ-модуле. Кроме 
того, есть еще одна разновидность обычных элементов управления УЛпао\$ — 
пользовательские элементы управления (сизют соп!го15). (Их создает сам про- 
граммист, и они не являются частью ОС, но работают как обычные элементы управ- 
ления, т. с. передают родительскому окну уведомления УМ СОММАЮО и обраба- 
тывают посылаемые ему сообщения.) Один из пользовательских элементов управ- 
ления описан в главе 22. 


Общие черты АсНу\еХ- и обычных элементов управления 


АсИПуеХ-элемент можно рассматривать как дочернее окно, подобно обычному 
элементу управления. В диалоговое окно его вставляет редактор диалоговых окон, 
после чего его идентификатор появляется в шаблоне ресурса. При динамическом 
создании элемента АсИуеХ («на лету») вызывается функция Стеше класса, пред- 
ставляющего данный элемент управления. Обычно это делается в обработчике 
сообщения М_СКЕАТЕ родительского окна. Чтобы выполнить какие-либо опера- 
ции с элементами управления Асйусх, вызывается функция-член С++ (так же, как 
и для элемента управления УЛп9оу5). Окно, содержащее элементы АсИУеХ, назы- 
вается контейнером (согиатег). 


Различия АсН\еХ- и обычных элементов управления 


Наиболее очевидная отличительная черта элементов управления АсйуеХ — нали- 
чие у них свойств и методов. Все функции С++, которые вы вызываете для рабо- 
ты с ними, так или иначе используют методы и свойства. Свойства имеют симво- 
лические имена, которым соответствуют целочисленные индексы. (Эти индексы 
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называются О5РШО, и мы познакомимся с ними в главе 23.) Разработчик элемен- 
та АсцуеХ присваивает каждому свойству определенное имя, скажем, ВасёСоют или 
аптИтейтийЬ, и тип, например, строка, целое или целое двойной точности. Для 
растровых изображений и значков существует даже такой тип свойства, как кар- 
тинка (Расге). Клиентская программа может устанавливать отдельные свойства 
элемента управления, задавая их целочисленные индексы и значения. Иногда У150а1 
сию МЕТ позволяет определить переменные-члены в классе клиентского окна, 
которые сопоставляются со свойствами элементов Асйуех, имеющихся в клиент- 
ском классе. Сгенерированный ООХ-код (Г1аю8 Раа Ехсвапее) осуществляет обмен 
информацией между свойствами элемента АсйуеХх и переменными-членами кли- 
ентского класса. 

Методы элементов управления АсйуеХ похожи на функции. У метода есть сим- 
вольное имя, набор параметров и возвращаемое значение. Для вызова метода 
вызывается функция-член класса С++, представляющего данный элемент Асйуех. 
Разработчик элемента управления может определить любые нужные методы, на- 
пример, Ргеюи$Уеат, ГошетСоттоЮоа$ и т. д. 

В отличие от обычных элементов управления элемент АсИуеХ не посылает 
своему контейнеру уведомляющих сообщений с префиксом «\/М_ › — вместо этого 
он «инициирует события» (Йге ап еуеп®). У события есть символическое имя, и оно 
может содержать произвольный набор параметров — в сущности это функция 
контейнера, которую вызывает элемент управления АсНуех. Как и уведомляющие 
сообщения от обычных элементов управления события не возвращают в элемент 
АсНуеХ данных. В качестве примеров событий назовем СИсЁ (щелчок), Кеуроши 
(нажатие клавиши) и №ешМош? (новый месяц). События сопоставляются клиент- 
скому классу так же, как и уведомляющие сообщения от элементов управления. 

В мире МЕС элементы управления АсНуеХ ведут себя как обычные дочерние 
окна, однако между окном контейнера и окном элемента управления есть весьма 
«толстая» прослойка кода. Кроме того, у элемента АсНуеХ окна может и не быть. 
При вызове Стеше само окно элемента управления не создается — вместо этого 
загружается его код, и ему выдается команда для активизации «на месте». После 
этого элемент АсиуеХ формирует свое окно, доступ к которому МЕС обеспечива- 
ет через указатель С\па. Однако настоятельно не рекомендуется применять в 
клиентской программе описатель РИпа элемента управления АсНуех. 

Элементы АсйуеХ хранятся в отдельных ОШ.-библиотеках, причем такие ОШ, 
обычно имеют расширение .осх. Приложение загружает РИ, по мере надобнос- 
ти, используя изощренные приемы СОМ-технологии, основанные на операциях 
с реестром УЛп4о\з. Но пока вам достаточно знать одно: элемент АсИуех, указан- 
ный на этапе разработки программы, загружается в период ее выполнения. Есте- 
ственно, при поставках приложения, требующего определенных элементов управ- 
ления АсйуеХ, вы должны включить в дистрибутивный комплект ОСХ-файлы и 
соответствующую программу установки. 


Установка элементов управления АсНуеХ 


Допустим, вы раздобыли «навороченный» элемент АсИУеХ и хотите задействовать 
его в своем проекте. В первую очередь нужно скопировать соответствующую О, 
на жесткий диск. Ее можно разместить где угодно, но элементы управления АсйуеХ 
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легче отслеживать, если все они размещены в одном месте, например, в систем- 
ном каталоге (обычно \\ИМРОУ/5\5У$ТЕМ в Мисгозой ХЛпаоуиз 95 и \У\УПММТ\$У5- 
ТЕМ32 в Мсгозой УЛп4оууз 2000/ХР). Скопируйте в тот же каталог файлы справ- 
ки (НГР) и лицензирования (ШС). 

Следующий шаг — регистрация элемента управления в реестре УЛпао%з. На 
самом деле элемент АсцуеХ регистрирует себя сам, когда клиент вызывает спе- 
циальную экспортируемую функцию. Обычно в качестве такого клиента высту- 
пает утилита Ве85уг32, которая получает имя элемента управления из командной 
строки. Эта утилита годится для сценариев установки. В проекте ВЕССОМР на 
компакт-диске есть программа КезСотр, позволяющая найти на диске заданный 
элемент управления. Некоторые элементы АсНуеХ требуют лицензирования, для 
чего иногда нужны дополнительные записи в реестре. (О работе с реестром У/п- 
90%’ см. главы 15, 17, 24 и 25.) Лицензируемые элементы управления АспуеХ обыч- 
но поставляются с программой установки, которая и заботится о создании соот- 
ветствующих записей. 

Зарегистрированный элемент АсйуеХ вы должны установить в каждый проект, 
в котором он используется. Это не означает, что нужно копировать ОСХ-файл — 
У15иа1 5гаю МЕТ создаст копию класса С++, оболочки соответствующего элемента 
управления, и последний появится в палитре элементов управления редактора 
диалоговых окон данного проекта. 

Для установки элемента управления АсНуеХх выберите команду ААА (1255 в меню 
Рго}есь, а в открывшемся диалоговом окне — МЕС С!аз$ Егот АсНуеХ Сопно! 


АТЕ ОТЕБВ АТЕ АТЕ Ргорегу 
Ргом4ег  Реогтпапс... Раде 


и ш 4% 


|| АТЬ бегуег АТ: тре  бепейс С++ 
| МиеБ бегисе ОБесЕ Яа5$ 


МЕС Са$$ 
РГО Т 


Выберите нужный элемент АсНуеХ в окне мастера АЧа С!а$$ Егот АсНуеХ Сопио! 
УЛгага. Вы увидите список всех элементов управления АсНуех, установленных в 
вашей системе в данный момент. Вот пример списка: 
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да С1а5$ РГО АОНУЕХ Соло едеНуех 


Уасоте {0 {пе АЧ С!а5$ гот Ас\еХ Сопиго| \Игага 
Ё ТБ иугаг а445 4а55е5 Ко уошг ргодесЕ Базе оп ап АсНуеХ согЁго!, 


_ М Випбте Сопго[<1,0> 
Ко9ыТ Согёто!<1.0> 
|Масготеффа Мазь Раскогу ОБесЕ<1.0> 


|Мего5ой: 005<1.0> 

|Мегозой: ОиескАгитацол Сопёго!<1,0> 
|Мего5оЁ: ОнескАгитавоп Ра <1.0> 
[Метозой: ОтескАлкаа дуепсе! <1.0> 


Элемент управления Са!епдаг 


Файл М$Са1осх — популярный элемент АсНуеХ М!сгозой Сайепааг, который ско- 
рее всего уже установлен и зарегистрирован на вашем компьютере. Если нет, не 
огорчайтесь — он есть на компакт-диске. 

На рис. 9-1 показан элемент управления Са!епдаг, расположенный внутри мо- 
дального диалогового окна. 


дснуеХ 012109 


Рис. 9-1. Использование элемента управления Сшепаат 


С этим элементом управления поставляется файл справки, в котором перечис- 
лены его свойства, методы и события (табл. 9-1). 


Табл. 9-1. Свойства, методы и события элемента управления Саепдаг 


Свойства Методы События 
ВасёСоют АБошВох АПетОраше 
Рау М№ хШау Веоте0ражще 
ДРауЕо Мех Мот СИСЕ 
ДауЕотсСоюг № хиИ\еев РЫСИсЕ 


см. след. стр. 
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Табл. 9-1. (продолжение) 


Свойства Методы События 
Рашепяр ЛМежтеат Кеуроиши 
Ейияшау Ргеюизрау КеуРге55 
апасСепЕГес! Ргалои$ Мор КеуОр 
СПАЕот РгалоизМеев МешМотр 
спаЕосоютг РгелоизУеаг Мешугаг 
спатезСоют Кей’езр 

Мот! Тоаау 

Мотепойр 

5рошОже$ вест; 

5Рошраух 

5рошНопгопиистпайте$ 

5рошТще 

5рои\егисистайтеу 

ТайеЕот! 

ГеРотсоюог 

Иаме 

Ижмие 5 Мий 

Угаг 


и 


В примере ЕхО9а мы задействуем свойства ВасёСо/от, Рау, Мош, Угаг и Илше. 
ВасйСоют — переменная типа ипяепеа 1опе, но используется как тип ОГЕ_СОГОК, 
а это почти то же, что и СОГОККЕЕ. Рау, Мот и Уеаг имеют тип $Во ицерег. Ише — 
специальный тип УАЮМАМТ (он описан в главе 25). Дата хранится в нем в виде 64- 
разрядного значения. 

У каждого из перечисленных свойств, методов и событий есть соответствую- 
щий целочисленный идентификатор. Сведения об именах, типах, последователь- 
ности аргументов и идентификаторах хранятся в элементе управления, откуда их 
извлекает У15иа| 5а4ю МЕТ во время конструирования контейнера. 


Программирование контейнера АсНуеХ-элементов 


МЕС и У150а1 Знаю МЕТ поддерживают применение элементов АсйуехХ как в диа- 
логовых окнах, так и в виде «дочерних окон». Чтобы задействовать элемент уп- 
равления Аспуех, надо знать, как он предоставляет доступ к своим свойствам и 
как ваш ООХ-код взаимодействует со значениями этих свойств. 


Доступ к свойствам 


Набор свойств, доступных на этапе разработки, определяет создатель элемента 
Аспусх. Эти свойства отображаются на страницах свойств, которые элемент управ- 
ления выводит в редакторе диалоговых окон, если щелкнуть его правой кнопкой 
и в контекстном меню выбрать Ргорегиез. Основная страница свойств элемента 
управления Сайепааг выглядит так: 
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ПОС_САЦЕМОАВ1 (АсёуеХ Сопёч 
М. 


в 


Сопго 


«МЕ Бол о а Баёа зоитсе> 
25 

дна, 8.25рь, зуе=Во 
ЗИ ва 

Медит 

дабе 

Зипдау 

Вабед 

`Анар 8.25рЕ 

ЗВ с, с, 160 

В] сопкобак 
`рабе 

| Те 

106 САЕМОАВТ ^ 


В период выполнения доступны все свойства элемента Аспуех, в том числе и 


те, что были доступны на этапе разработки. Однако некоторые свойства могут быть 
определены «только для чтения». 


Классы-оболочки С++, создаваемые 
\М!иа! Зи4ю „МЕТ для Ас \еХ-элемента 


При добавлении в проект АсйуеХ-элемента среда У15ча1 Зо .МЕТ — в соответ- 
ствии с набором свойств и методов данного элемента управления — генерирует 
класс-оболочку С++, производный от С\па. Сгенерированный класс содержит 
функции-члены для всех свойств и методов, а также конструкторы, которые можно 
задействовать для динамического создания экземпляров данного элемента управ- 
ления. (\У15иа! $а1ю „МЕТ также генерирует классы-оболочки объектов, использу- 
емых элементом управления.) Вот несколько типичных функций-членов из фай- 
ла ССмепааг.В, которые У15иа1 $ о „МЕТ генерирует для элемента управления 
Саепааг: 


ип$19пе4 10п9 дет_ВаскСо1ог() 
{ 
ип$19пе49 10п9 гези1т; 
ТпуокеНе1 рег (ОТ5РТО_ВАСКСОЕОВ, 
ОТЗРАТСН_РВОРЕВТУСЕТ, УТ_0Т4, (\019*)&гези1{, МЕ); 
гетигп гези1т; 
} 
\019 ри_ВаскСо1ог(ипз19пеа 1опд пем\а1ие) 
{ 
эфа{1с ВУТЕ рагт$[] = \УТ$_ 114 
ТпуокеНе1рег(ОТЗРТО_ВАСКСОЕОН, ОТЗРАТСН_РВОРЕВТУРИТ, 
\УТ_ЕМРТУ, МЕ, рагтз, пем\а1ие); 
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ЗПоге д9ет_Вау() 
{ 
эпогЕ гези1т; 
ТпуокеНе1рег(0х11, ОТЗРАТСН_РАОРЕВТУСЕТ, 
УТ_Т2, (\014*)&гези1*, МЕ) 
гефигп гези1т; 
} 
\019 ри_Оау(зПогЕ пем\а1ие) 
{ 
ЗТа{1с ВУТЕ рагт$[] = \УТ$_12 
Тпуокене1рег(0х11, ОТЗРАТСН_РВОРЕВТУРИТ, \УТ_ЕМРТУ, 
МИЕЕ, рагтз, пем\а1ие):; 
} 
ЕРОТЗРАТСН дет_ВауРоп*() 
{ 
ЕРОТЗРАТСН гези1*; 
ТпуокеНе1рег(0х1, ОТЗРАТСН_РВОРЕВТУСЕТ, 
\УТ_ОТ$РАТСН, (\0149*)&гези14, МЕ) 
гефигп гези1т; 
} 
\019 ри{_БауРоп{ (ЕРОТЗРАТСН пем\атие) 
{ 
эТа{1с ВУТЕ рагтз[] = УТ$_ОТЗРАТСН 
ТпуокеНе1рег(0х1, ОТЗРАТСН_РАОРЕВТУРИТ, 
\УТ_ЕМРТУ, МЕ, рагтз, пем\а1ие); 
} 
и1319пе4 10п9 дет_БауРопЕСо1ог() 
{ 
ип$101е4 10опд гезил*; ; 
ТпуокеНе1рег(0х2, ОТЗРАТСН_РВОРЕВТУСЕТ, УТ_ 114, 
(\014*)&гези14, МЕ): 
гефтигп гези; 
} 
№019 ри{_БауРопЕСо1ог(ипз19пе9 1опа пем\атие) 
{ 
зтаф1с ВУТЕ рагтз[] = \Т$_014; 
ТпуокеНе1рег(0х2, ОТЗРАТСН_РВОРЕВТУРИТ, 
УТ_ЕМРТУ, МУ, рагмз, пе\\а1ие): 
} 
эпогЕ дет_Оаутепатв() 
{ 
ЗПогЕ гези1+; 
ТпуокеНе]рег(0х12, ОТЗРАТСН_РВОРЕВТУВЕТ, \МТ_12, 
(№014*)&гези14, МЕ): 
гефигп гези1*: 
} 
\014 ри*_БауепдеИ(зпоге пем\а1ие) 
{ 
Этаф1с ВУТЕ рагтз[] = УТ$_12 


ПИН ОИИЗИИ 
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ТпуокеНе1рег(0х12, ОТЗРАТСН_РВОРЕВТУРИТ, 
\Т_ЕМРТУ, МЕ, рагмз, пем\а1ие); 
} 
эпогЕ дее_ЕР1гз{Вау() 
{ 
эПоге гези1*; 
ТпуокеНе1рег(0х13, ОТЗРАТСН_РВОРЕВТУСЕТ, 
\МТ_12, (\019*)&гези1{, МЕ); 
гетигп гези1т; 
} 
\019 ри_Р1г51бау(зпог* пем\а1ие) 
{ 
${а{1с ВУТЕ рагмз[] = \Т$_Т2 
Тпуокене1рег(0х13, ОТЗРАТСН_РВОРЕВТУРИТ, 
\Т ЕМРТУ, МЕ, рагтз, пем\Матие); 
} 


\у014 М№ех{Вау() 
{ у 
ТпуокеНе]рег(0х16, ОТЗРАТСН_МЕТНОВ, 
МТ ЕМРТУ, МИ, МЕ); 
} 
\019 №ех{МопЕй() 
{ 
ТпуокеНе1рег(0х17, ОТЗРАТСН_МЕТНОВ, 
\УТ_ЕМРТУ, МЕ, МЕ); 
} 
\01а Мех{Меек() 
{ 
ТпуокеНе]рег(0х18, ОТЗРАТСН_МЕТНОВ, 
МТ ЕМРТУ, МЕ, МЕ); 
} 
\019 №ех{Уеаг() 
{ 
ТиуокеНне1рег(0х19, ОТЗРАТСН_МЕТНОО, 
\Т_ЕМРТУ, МЕ, МЕ); 


Насчет кода этих функций особо не беспокойтесь, однако заметьте, что пер- 
вый параметр в вызовах каждой из /иговеНерег-функций можно сопоставить с 
диспетчерским идентификатором соответствувющего свойства или метода в списке 
свойств элемента управления Саепааг. Как видите, для каждого свойства существуют 
пары отдельных функций «ре › (получить) и «5е/ › (установить). Для вызова ме- 
тода вы просто вызываете нужную функцию. Например, для вызова метода Мех ау 
из функции класса диалогового окна можно написать так: 


т_са1епдаг. №ех{Оау( ); 


Здесь т_сшепааг — это объект класса ССщепаат, служащего оболочкой для 
элемента управления Саепааг. 
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ив п 
Поддержка АсНуеХ-элементов в МЕС АррИсаНоп \М/гага 


Если в МЕС АррИсайоп \/гагА установлен флажок АсцуеХ Сопиго[ (а по умолча- 
нию это так), в функцию-член м/т аисе класса приложения вставляется строка: 


АГхЕпаб1еСопЕго1Сопфа1тег():; 


Кроме того, в файле 5(АЁх.В вашего проекта появляется строка: 


Н1пс1иде <ахд1зр. > 


Если вы решили использовать элементы Аснуех в существующем проекте, 
можете просто вставить эти две строки. 


Мастер Ада С1аз$ МИгаг4 и диалоговое окно контейнера 


Если вы создали шаблон диалогового окна с помощью редактора диалоговых окон, 
то знаете, что, используя АЧА С1!а55 УЛгага, для этого окна можно сгенерировать 
класс С++. Если шаблон содержит АсйуеХ-элементы, Аа Метьег УанаЫе можно 
задействовать для добавления переменных-членов и обработчиков событий. 


Переменные-члены класса диалогового окна или применение класса-оболочки 


Какого типа переменные-члены добавлять в диалоговое окно для элемента управ- 
ления АсИуеХ? Чтобы установить свойство элемента управления до вызова РоМоаа/ 
для этого диалогового окна, можно добавить переменную, соответствующую это- 
му свойству. А чтобы менять свойства внутри функций-членов диалогового окна, 
придется добавить переменную-объект класса-оболочки элемента управления 
АСНУЕХ. - 

Сейчас самое время вспомнить логику работы ООХ МЕС. Вернемся к диалого- 
вому окну ЕхОба из главы 8. Функция СГщов::ОттиГ ов вызывает С\та::Ораше- 
Рей(ЕАГЗЕ) для считывания значений переменных-членов, а функция СО#4ов::ОпОК 
вызывает Пращереа (ТКОЕ) для записи в эти переменные. Допустим, вы добави- 
ли по одной переменной для каждого свойства элемента управления АсйуеХ и 
хотите получить значение свойства Уаше в обработчике сообщения от кнопки. 
Если вызвать Оражереа(ЕАГ5Е), считаются значения всех свойств всех элементов 
управления диалогового окна — ясно, что это излишняя трата времени. Эффек- 
тивнее не использовать переменную для каждого свойства, а вместо этого вызвать 
функцию с префиксом «ве › класса-оболочки. Для этого надо, используя У15иа1 
Укию „МЕТ, создать переменную-объект класса-оболочки. 

Предположим, у нас есть класс-оболочка ССшепааг для элемента управления 
Саепааг, а в классе диалогового окна — переменная-член т сшщепааг. Тогда зна- 
чение свойства Уаше можно получить так: 


СОТе\аг1апЕ уаг = п_са1епдаг. бет\а1ие(); 


зоооомоноомминожнвововвннознппипнпипиши 


Примечание Тип УАКАМТ и класс СОеУанаи! описаны в главе 235. 


Теперь рассмотрим другой случай: вы хотите перед отображением элемента 
управления установить 5-й день месяца. Для этого добавьте в класс диалогового 
окна переменную-член 7 $СаШау типа 5Воге ицевег, соответствующую свойству 
Рау. Затем добавьте в функцию РореаЕхсрапве вызов: 
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00Х_ОС$поге(рох, ТО_САГЕМОАВТ, 0х11, м_$Са10ау); 


Третий параметр — идентификатор свойства Рау, который можно найти в 
функциях ре! Рау и риё Рау, созданных средой У15ща! и ю „МЕТ для элемента 
управления. Диалоговое окно создается и отображается так: 


СМу01а109 919; 
919.т_$Са1Вау = 5; 
919.00Мода1(); 


Перед отображением элемента управления на экране ООХ-код позаботится об 
установке значения свойства в соответствии со значением переменной-члена. 
Дополнительного программирования это не требует. ООХ-код при щелчке кноп- 
ки ОК, конечно, установит значение переменной-члена в соответствии со значе- 
нием свойства. 


Примечание Даже если У15иа1 $ юо .МЕТ правильно определит свойства эле- 
мента управления, она не обязательно создаст переменные-члены для всех 
свойств. В частности, не существует ООХ-функций для свойств типа 
УАЮМАМТ, подобных свойству Ияще элемента Саепааг. Для таких свойств 
понадобится класс-оболочка. 


Привязка событий элементов АсёуеХ 


Окно Ргорегез, связанное с окном С1а$$ У1е\/ позволяет сопоставлять события от 
элементов АспуеХ с функциями-членами так же, как это делается для УЛп4о\з- 
сообщений и командных сообщений от элементов управления. Если в классе ди- 
алогового окна есть элементы АсНуУеХ, мастера, доступные из окна Ргорегие$, со- 
здают и поддерживают карту приема событий (еуепи 9пК гар), в которой опре- 
делено соответствие между событиями и их функциями-обработчиками. С кон- 
кретным кодом в файлах АсиуеХГ\аю2.В и АсиуеХП!а1о8.срр мы познакомимся 
попозже. 


Примечание У элементов АсйуеХ есть неприятная особенность — иницииро- 
вать события до того, как программа готова их получить. Если в обра- 
ботчике события используются окна или указатели на объекты С++, то 
прежде, чем обращаться к ним, надо проверить, существуют ли эти объекты. 

ТОО СО АК ТВ ИНОЕ ЕТО ОЕ 


Закрепление элементов Асё\ехХ в памяти 


Обычно элемент АсйуеХ проецируется на адресное пространство вашего процесса 
только на время, пока активно его родительское диалоговое окно. Это значит, что 
всякий раз, когда пользователь открывает это окно, элемент приходится загружать 
заново. Благодаря дисковому кэшу повторная загрузка проходит быстрее перво- 
начальной. Тем не менее, чтобы повысить производительность, можно закрепить 
(оставить) элемент Асйуех в памяти. Для этого в переопределенную функцию 
Опттй00ов после вызова функции базового класса добавьте строку: 


АЕхО1егоскСоптго1 (т_са1епдаг. 6е{С1$19()); 
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—ж— 


Элемент АсйуеХ останется спроецированным на адресное пространство процес- 
са до завершения программы или вызова функции АОеИтюосёСопио, 


Пример Ех09а: контейнер АсН\уеХ 


Пора создать приложение, использующее элемент управления Саепааг в диало- 
ГОвОМ ОКНЕ. 


1. Зарегистрируйте элемент управления Са|епдаг. Если элемента управле- 
ния нет в системной папке, скопируйте файлы М$Са1.осх, М5Са р и М$Са1спи 
в системный каталог и зарегистрируйте элемент управления, запустив КЕССОМР. 

2. С помощью МЕС АррИсаНоп \/1хага создайте проект Ех09а. На странице 
АррИсацоп Туре мастера установите переключатель в положение шее аоситепь 
а на странице Аауапсеа Ееа(игез сбросьте флажок Рипипр апа рипе ргейеху. 
Остальные параметры оставьте без изменения. Проверьте, установлен ли фла- 
жок АсцуеХ сопго[5: 


МЕС АррйсаНов га еноЗа 


Адуапсед Геаигез 
эресфу а4опа! зиррои ко Бый4 Алко усиг аррйсаноп. 


3. Установите элемент управления Сайепдаг в проект Ех09а. В меню Рго}есе 
выберите команду АЧа С!а55. В окне АД С1а$$ выберите МЕС С!аз$ Егот АснуеХ 
и щелкните Ореп. В окне АДА С!а5з Егот АсНуеХ Сопиго! ХЯтага в списке до- 
ступных элементов управления выберите Са!епааг Сопиго! 9.0, как показано ниже 
на рисунке У15ца1 са „МЕТ создаст соответствующий класс в каталоге ЕхО9л. 
4. Отредактируйте класс элемента управления Са!епдаг для обработки 
справочных сообщений. Добавьте в Саепааг.срр код таблицы сообщений: 


ВЕСТМ_МЕЗЗАВЕ_МАР(ССа1епдаг, С\па) 
О№_ММ_НЕЕРТМЕО() 
ЕМО_МЕЗЗАСЕ_МАР() 


В тот же файл добавьте функцию ОпНертрю: 


ВОО. ССа1епдаг: : ОпНе1рТп о (НЕЕРТМЕОх рНе1рТпРо) 

{ 

// Отредактируйте эту строку в соответствии с особенностями вашей системы 
: МапНе1р (бетЗатеНипа (), “с: \\и1пп\\зуз1ет32\\пзса1. Н1р" 
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НЕЕР_ЕТМОЕВ, 0); 
гетигп РАЗЕ; 
} 


В Саепааг.В добавьте прототип функции и объявление таблицы сообщений: 


рготестед: 
аРх_тз9 800. ОпНне1рТпРо(НЕЕРТМЕО» рНе1рТпфо); 
ОЕСГАВЕ_МЕЗЗАбЕ_МАР() 


Функция ОпНерт) вызывается, когда пользователь нажимает клавишу Е1, 
при условии что фокус ввода установлен на элементе управления Са|епдаг. Мы 
вынуждены добавлять код вручную, так как У15ча1 $910 .МЕТ не изменяет сге- 


нерированные классы элементов Асйуех. 


Примечание Макрос ОМ УМ _НЕГЫШМЕО служит для привязки сообщения ИМ НЕГР. 
Вы можете применять ОМ УМ _НЕЁГР/ШМЕО в любом классе диалогового 
окна или окна представления, чтобы затем вызывать в его обработчике 
любую справочную систему. 


А49 Са55 Егогл веЗмех сопыго! УПА: ак0За 


\екоте 10 {пе АЗА С1а$$ Ргот Ас\ех Сопёго! МИгагЧ 
ТРЕ иугаг4 445 Чаззез Ко уоиг ргодесЕ Базе оп ап АсЁмеХ солЁто!, 


5. С помощью редактора диалоговых окон создайте новый ресурс диало- 
гового окна. Выберите в меню Рго}]ес! среды разработки команду АЯ Кезоигсе 
и в открывшемся одноименном диалоговом окне щелкните строку О!а!05$, а 
затем — кнопку Меуу. У151а1 $70 создаст новый диалоговый ресурс. Измени- 
те идентификатор по умолчанию на ШО АСПЕХРАГОС, свойству СарНоп 
присвойте значение АсйуеХ 1012108, а свойству Сощехе Не — ТВОЕ. Оставьте 
созданные по умолчанию кнопки ОК и Сапсе! с идентификаторами ШОК и 
РСАМСЕЕ и добавьте другие элементы управления в соответствии с рис. 9-1. 
Сделайте кнопку 5е/есЕ Оа{е кнопкой по умолчанию. Щелкните диалоговое окно 
правой кнопкой и в контекстном меню выберите Ил5егЕ АсйуеХ Сопио), а в 
списке — элемент управления Са!епдаг. Задайте порядок обхода по нажатию 
клавиши ТаБ. Присвойте элементам управления идентификаторы в соответствии 


с таблицей: 
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Элемент управления Идентификатор 
Сайепааг Ш)РС_САГЕМРАК1 
Кнопка 5&есЕ Рае ШРС_$5ЫЕСТБАТЕ 
Поле ввода ШРС _РАУ 

Поле ввода Ш)С_МОМТН 
Поле ввода 1РС_УЕАК 
Кнопка Мех! еек 1РС_МЕХТУЕЕК 


АИ, 

6. Используя У15иа1 $10 „МЕТ, создайте класс САстие Хор. В меню Рго]ес 
выберите команду Аа С!а55. В окне МЕС С!аз5 УЛхагА создайте класс САсйое- 
ХО я/108, производный от Сов и основанный на шаблоне ШРЬ_АСПУЕХМАГОС. 
Обязательно в качестве базового выберите класс СР! 

Щелкните правой кнопкой класс САсйоеХРов в С1аз5 \У1е\ и в контекст- 
ном меню выберите Ргорегие5. В окне Ргорегиез щелкните кнопку Оуегиае$ и 
создайте переопределенные функции ОптИБюов и ОпОК. 

В окне Ргорегие$ щелкните кнопку Еуепи$ и добавьте перечисленные в таб- 
лице функции-обработчики. Чтобы добавить обработчик события, в открыв- 
шемся списке выберите нужную, щелкните стрелку «вниз» рядом с ней и вы- 
берите команду с приставкой <Ааа>. Функция откроется в редакторе кода. 
Повторите эту последовательность операций для каждого обработчика. 


ии аааааааапааоаааацации 
Идентификатор объекта Сообщение Функция-член 


ШРС_САГЕМРАК1 М№еиМотр М№ешМотрСщепаа! 1 
12С_$ЕЕРЕСТРАТЕ ВМ СИСКЕР ОпВисйсвебаечае 
1Р2С_МЕХТУЕЕК ВМ_СИСКЕР ОпВисИсвейМехеей 


7. Используя А44 МетьЬег Уа1аЫе \У1гага, добавьте в класс САсшехП4щоя 
переменные-члены. Щелкните правой кнопкой класс САснуеХО!а1ое в окне 
С1а5$ У1е\, в контекстном меню выберите Ааа УанаЫе и добавьте переменные- 
члены 71_сшепаах, т_5ау, т_5Мот№ и т_5Уеаг: 


\!асоте {0 {Пе АЗ Метбег УачаЫе \/2: 


ТН ‘мази а445 а тетьег уайаЫе ко усиг аз, злись, ог ипоп, 


ГЛАВА 9 Использование элементов управления Асй\уеХ 195 


Примечание Вы могли бы подумать, что вкладка АсНуеХ Еуеп($ предназначе- 
на для привязки событий элементов АсйуеХ к функциями контейнера. 
Но это не так: разработчики используют ее для определения событий 
создаваемого элемента управления Асйуех. 


8. Отредактируйте класс САсНоеХПОлищов. Добавьте переменные-члены т _оа/- 
Ише и т_ВасеСоот и затем отредактируйте код двух переопределенных фун- 
кций и функций-обработчиков (ОттйП ов, МерМот№Сиепаа!1, ОпВиСИсвеа- 
5@ечаще, ОпВпСйсвеа№ехишеей и ОпОК). Далее показан весь код для класса 
диалогового окна — новый код выделен. 
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Функция ОпВиСйсвебееснае вызывается по щелчку кнопки 5@есЕ Рае, 
получает значения дня, месяца и года из полей ввода и передает их свойствам 
элемента управления. АЧа МетЬег УапйаЫе УЙгага не умеет создавать РОХ-код 
для свойства ВасйСо/от, поэтому вам придется сделать это вручную. Кроме того, 
для типа УАЮАМТ нет функций ООХ, поэтому необходимо добавить в функции 
ОптИ 108 и ОпОК код, присваивающий и получающий дату в свойстве Из/ще. 

9. Свяжите диалоговое окно с окном представления. В окне Ргорегиез ути- 
литы (1255 У1е\у создайте обработчик сообщения УМ _ГВИТТОМРО\М и отре- 
дактируйте его: 


\у014 СЕхО9а\1ем: : ОпЕВиопбомп(ИТМТ пЕ1адз, СРо1п ро1пе) 
{ 

САсф1\уех01а109 919; 

919.т_ВаскСо1ог = А6В(255, 251, 240); // 11911 уе110м 


8—2064 
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С01еБатеТ1те тодау = С01ерахеТ1ме: : беСиггепЕТ1те(); 
919.п_уаг\а1ие = С01ебафеТ1те(тодау. де*_Уеаг(), 
Тодау. дет_Моптп(), 
Тодау. де _Пау(), 0, 0, 0); 
11 (919.00Мода1() == ТООК) { 
С01ебатеТ1те дафе(919.т_уаг\а1ие); 
АГхМеззадеВох( дате. Рогтат ("ХВ %а, %У“)); 
} 


Код устанавливает светло-желтый цвет фона и текущий день в качестве 
используемой даты, показывает диалоговое окно и сообщает, какую дату вер- 
нул элемент управления Са!епдаг. Вам нужно включить АснуеХГ\а!юр.В в ЕхО9а- 
Уехусрр. 

10. Измените виртуальную функцию ОпнОгаи в файле Ех09а\У1е\у.срр. Что- 
бы предложить пользователю нажать левую кнопку мыши, добавьте в функцию 
Опрташ строку: 


р0С->Техе0и{(0, 0, “Ргезз пе 1еРЕ тоизе Биффоп пеге. "): 


11. Соберите оттестируйте приложение Ех09л. Откройте диалоговое окно, 
введите дату в три поля ввода и щелкните кнопку $е1ес! Рае. Щелкните кноп- 
ку Мехи \есК. Попытайтесь перенести выбранную дату прямо в новый месяц — 
вы увидите окно сообщения, вызываемое событием МешМот. Окончательную 
дату вы увидите в другом окне сообщения, щелкнув кнопку ОК. 


_ В процессе функци 
_ обрабатывает сообщ, 
равления, так и элемента 
всеми элементами управле 
ты АСНУеХ и не входят в фа 
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ник элемента управлен 
класса-оболочки. 


АсНуеХ-элементы в НТМЕ-файлах 


Вы видели АсйуеХх-элемент Саепадаг в модальном диалоговом окне МЕС. Его мож- 
но использовать и на \/еБ-странице. Следующий НТМГ-код будет работать, если 
на машине установлен и зарегистрирован элемент управления Саепааг: 


<ОВУЕСТ 


С1А$$5Т0="с1$19:8Е27С928-1264-101С-8А2Е-040224009С02" 
МТОТН=300 НЕТСНТ=200 ВОВОЕВ=1 НЗРАСЕ=5 ТО=са1епдаг> 


<РАВАМ МАМЕ=“”Вау” МАЕИЕ=7> 
<РАНАМ МАМЕ="Мопеи” \УАЦИЕ=11> 
<РАВАМ МАМЕ=“Уеаг” \УАЕИУЕ=1998> 
</ОВУЕСТ> 


Атрибут СГА$ЗТО, значение которого совпадает со значением в ресурсе диало- 


гового окна из примера ЕхО9а, идентифицирует в реестре элемент управления 
Сайепааг, благодаря чему. браузер может загрузить элемент Асйуех. 


Создание элементов Асй\ехХ в период выполнения 


Вы видели, как с помощью редактора диалоговых окон добавлять элементы Асйуех 
в период разработки программы. Если же нужно создать элемент управления в 
период выполнения, не применяя шаблоны ресурсов, сделайте следующее. 


1; 


Добавьте компонент в проект. У15иа1 $аю „МЕТ создаст файлы для класса-обо- 
лочки. 

Добавьте в класс диалогового окна или другой оконный класс С++ перемен- 
ную-член типа класс-оболочка. Внедренный таким образом объект С++ будет 
создаваться и разрушаться вместе с оконным объектом. 

В меню У1е\уи выберите Кезоигсе У1леу”. В окне Кезоигсе У1е\м щелкните правой 
кнопкой ВС-файл и в контекстном меню выберите Кезоигсе 5угтаБо!{5. Добавьте 
константу-идентификатор для нового элемента управления. 

Если родительское окно — диалоговое, то в окне Ргорег4е$ утилиты С1а$$ У1е\ 
переопределите функцию СБёов::ОттИ ов. Для других окон, кроме осно- 
ванных на классе СОйжюов, сопоставьге сообщение М_СКЕАТЕ. В любом слу- 
чае новая функция должна вызывать функцию-член Стеше внедренного эле- 
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мента управления Асйуех. Этот вызов неявно приведет к отображению ново- 
го элемента управления в диалоговом окне. Он уничтожается при уничтоже- 
нии родительского окна. 

5. В классе родительского окна вручную добавьте обработчики событий для но- 


вого элемента управления. Не забудьте добавить макросы таблицы приема 
событий. 


И 
Совет Доступные в окне Ргорегиез мастера не помогут в работе с таблицей 


приема событий, если АсНуеХ-элемент создается в проекте динамиче- 
ски. Попробуйте вставить элемент управления в диалог в другом, вре- 
менном проскте. Настроив таблицу приема всех событий, скопируйте код 
в класс родительского окна в основном проекте. 


Пример Ех0ЭЬ: Асй\уеХ-элемент в браузере 


Основная часть функциональности браузера содержится в одном болышом эле- 

менте АспуеХ — 5Ваосу\.аИ. Запуская Имегпег Ехр!огег, вы вызываете маленькую 

программу-оболочку, которая загружает этот элемент управления \/еБ-браузера 

в свое основное окно. 

Примечание Полную документацию по свойствам, методам и событиям эле- 
мента управления \еБВгоуузег вы найдете в интерактивной библиотеке 
М$ОМ в составе \У15иа1 Зла ю. МЕТ. 


Такая модульная архитектура позволяет вам очень легко написать свою про- 
грамму-браузер. ЕхО9Ь создает двухоконный браузер, в котором выводится стра- 
ница системы поиска, а рядом — обычная страница: 


Соозе 


| Рго9ио5 & Тесто 9е$ Е падез 


|" М5ОМ Нбгагу Ра 5х оа 56 


|| Соде Сепкег зеНез оп МЕТ 
Ооипюа95 | аеуеюрте | 
| Нов-То Тодех | Мраков 45 оп-с | 


М5ОМ Мадагте | эгеатид пед | 
Сол } ргезегканоп аЁ 


| биос иво вм! Сецне бообе Зеагсй 
| Зирро . и Г 


аррйсаНоп$ и5Ё | 
1 Реуаюорег Соптопйу Зи „МЕТ аге | 
| Ттамилд, Сагеег & Ггагпемогк. 
| Еуеп5 {есргиса| декай 
| Зибзспрноп5 апд #рз апд +1 
} Рагпегз & Сенисаноп 


И Ргобезюпа! 
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Окно представления содержит два элемента управления \еБВго\узег, которые 


занимают всю клиентскую область. Когда пользователь щелкает ссылку в поиско- 
вом (левом) элементе управления, программа обрабатывает эту команду и пере- 
направляет резульгат в целевой (правый) элемент управления. 


1: 


Убедитесь, что элемент управления У\еБВгоуузег зарегистрирован. У вас, 
конечно, установлен М1сгозой Имегиег ЕхрЮгег самой последней версии, так 
как она необходима \У15ца1 5 о МЕТ, поэтому элемент управления Хе Вгоугзег 
должен быть зарегистрирован. Если нужно, загрузите ИцегоеЕ Ехр|огег с сайта 
рир:\\шшошлистозой.сот. 

С помощью МЕС АррИсаНоп \У/12аг4 создайте проект Ех09Ъ. На странице 
АррИсаНоп Туре мастера установите переключатель в положение Зтее доситепь, 
а на странице Адуапсеа Ееагагез сбросьте флажок Рипипе апа рипе ргемеху. 
Остальные параметры оставьге без изменения. Проверьте, установлен ли фла- 
жок АсНуеХ Сопио}{5, как в примере ЕхО9а. 

Установите элемент управления \еБВгоуузег в проект Ех09Ь. Выберите 
команду АЗ С1а5$ в меню Рго]ес! и в открывшемся диалоговом окне выберите 
МЕС С1а5$ Егот АсиуеХ Сопиго|. В открывшемся списке выберите элемент Мисго- 
зой \УеЬ Вгоуузег, У15иа1 За Йо МЕТ предложит создать классы-оболочки для двух 
интерфейсов: ЛУеБВгоижет и ПУеБВтоижзет2. Выберите ПеБВтгои»ет2. У15иа1 Знаю 
„МЕТ создаст класс-оболочку для ПЯеБВтои5ет2 и добавит соответствующие 
файлы в проект. 

Добавьте в класс СЕх09БИеи) две переменные-члены типа Се БВгои5ег. 
Проще всего это сделать вручную, добавив в заголовочный файл строки: 


рг1\уате: 
СмебВгомзег2 т_Тагде*; 
СМебВгомзег? т_зеагсй: 


Не забудьте проверить наличие оператора #тсшае для файла СеБВгом- 
зег2.в. 
Добавьте константы-идентификаторы дочерних окон для обоих элемен- 
тов управления. Щелкните правой кнопкой класс «вид» в Кезоигсе У1е\ и в 
контекстном меню выберите Кезоигсе 5утБо|5. Добавьте символы Ш ВКО\- 
5ЕК_5ЕАКСН и Ш_ВКО\УЗЕКЮ_ТАКСЕТ. 
Добавьте статическую переменную-член типа массив символов для 
хранения ОВТ-адреса поисковой системы Соозе. В объявление класса в 
ЕхО9Б\1е\у.В добавьте статическую переменную: 


рг1\уате: 
Эфат1с сопзф спаг з_епд1пебоод1е[]; 


Затем в файл ЕхО9Б\У1еуусрр вне кода всех функций добавьте определение: 
сопз{ спаг СЕхО9Б\1ем: :з_епд1пебоо91е[] =.. "ПЕЁр: //ммм. 90091е. сом/": 


Используя окно Ргорег|е$ утилиты С1а$5 У1еу’, создайте обработчики 
сообщений УМ _СКЕАТЕ и УМ 5$17Е для класса «вид». Затем измените код 
обработчиков в ЕхО9Б\1еуусрр: 
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11 СЕхО9Б\1ем: : ОпСгеате (ЕРСВЕАТЕЗТВУСТ 1рСгеахеЗ+гис+) 
{ 
1 (С\М1ем: :ОпСгеате(1рСгеазе$гисЕ) == -1) 
гефигп -1; 


ОМОВО 9м5+у1е = М5_\МТЗТВЕЕ : М$_СНТЕО; 
11 (т_зеагсй. Сгеафе( МЕ, амЗфу1е, СВест(0, 0, 100, 100), 
111$, ТО_ВАОМЗЕН_ЗЕАВСН) == 0) { 
АГхМеззадеВох( "/паБ1е то сгеафе зеагсп соптго1!\п”); 
гефигп -1; 
} 
п_еагсй. Мау1 дате ( з_еп91пебо0д1е, М, Мише, МЕ, М) 


11 (т_Тагде{. Сгеаке(МИЕЕ, диЗ+у1е, СВес+(0, 0, 100, 100), 
111$, ТО_ВАОМЗЕН_ТАВСЕТ) == 0) { 
АГхМеззадеВох( "ЦпаБ1е фо сгеафе тагдет соп+го1!\п") 
гефигп -1; 
} 
п_Тагое{.боНоте(); // как задано в параметрах Тпфегпе{ Ехр1огег 


гефигп 0; 


\014 СЕхОЭБ\У1ем: :0п512е(ИТМТ пТуре, 1пЕ сх, 1п{ су) 
{ 
С\1ем: :01$12е(пТуре, сх, су); 


СВесЕ гестС11епт; 

бе{С11епВест( гес+С11еп+); 

СВесЕ гесфВгомзе( гес+С11еп{); 
гес{Вгомзе. г19пЕ = гесеС11епе. г19пе / 2; 
СВесЕ гесф5еагсп( гес+С11еп*); 
гес{5еагсй.1еР = гесфС11епт. г19пе / 2; 


п_Тагдее. ри{_М19тп( гесЕВгомзе. г1дп{ - гес+Вгомзе. 1ет+); 
п_Тагде{. ри _Не1 опт ( гесЕВгомзе. Бо{от - гесВгомзе. ор); 
п_Тагдет. Урдатем1пдом( ); 


т_зеагсп. ри*_1ет 1 ( гест5еагсн. 1ет+); 

п_зеагсй. ри{_М19( гесЕЗеагсй. г19В{ - гес+$еагсп. 1е++); 
п_зеагсп. ри _Не19 п ( гесЕЗеагсН. Бо{от - гес+$еагси. +ор); 
п_зеагсй. Урдафем1пдом( ); 


Функция ОпСтеше создает внутри окна представления два окна браузера. 
Правое отображает основную страницу системы поиска Сооз!е, а левое — до- 
машнюю страницу, заданную в параметрах Интернета в панели управления. 
Функция Оп5#е, вызываемая при всяком изменении размера окна представле- 
ния, гарантирует, что окна браузера полностью заполняют окно класса «вид». 
Функции-члены ри! И и ри Нее класса С\еБВтоижет2 позволяют уста- 
новить свойства УЛ (ширина) и Не?! (высота). 
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8. Добавьте в файлы Ех09БУ1е\у макросы приема событий. Мастера, доступ- 
ные в окне Ргорегиез, не могут выполнить привязку событий для динамически 
создаваемых элементов Асйуех, поэтому придется сделать это вручную. Добавьте 
внутрь объявления класса в файле ЕхОЭБ\еу\Ь строки: 


рготестед: 
атх_т$9 у01а ОпВегогеМау1дафеЕхр1огег1(ЕРСТУТВ ЦВЕ 
1опд9 РЛадз, ЕРСТУТА Тагде{ЕгатеМате, 
\/АВТАМТ РАВ» Роз{Оафа, [РСТЭТВ Неадегз, ВООЕ РАВ* Сапсе1) 
аГх_тз9 у0149 Опт1{1еСпапдеЕхр1огег2 (ЕРСТЗТВ Техе); 
ОБЕСЕАВЕ_Е\УЕМТУТМК_МАР() 


Затем добавьте этот код в файл ЕхО9Б\1еуусрр: 


ВЕСТМ_Е\ЕМТУТМК_МАР(СЕхО9б\У1ем, С\У1ем) 
ОМ_Е\МЕМТ(СЕхо9Б\/1ем, ТО_ВАОМЗЕВ_ЗЕАВСН, 100, 
ОпВеГгогеМау1датеЕхр1огег1, УТЗ_ВУТВ \Т$_Т4 \Т$_ВУТВ 
\Ут5_РУАВТАМТ \УТ$_В$УТВ \УТ$_РВОО|) 
ОМ_Е\ЕМТ(СЕХО9Б\У1ем, ТО_ВВОМЗЕВ_ТАНСЕТ, 113, 
Опт1{1еСпапдеЕхр1огег2, \ТЗ_ВУТН) 
ЕМО_ЕУЕМТЗТМК_МАР() 


9. Добавьте две функции-обработчики событий. Добавьте в файл ЕхО9Ь- 
Уе\усрр функции-члены: 


\019 СЕхо9Б\1ем: :ОпВегогеМау1датеЕхр1огег1 (1РСТУТВ УВЕ 
10оп9 Е1ад$, ЕРСТУТВ ТагдетЕгамемаме, 
\УАВТАМТ РАВ» Роз{Бафа, [РСТЗТВА Неадегз, ВОО РАА* Сапсе1) 


ТВАСЕ( “СЕхО96\1ем: :ОпВегогеМау1датеЕхр1огегл -ИВЕ = %з\п”, ЦВЕ); 


1 (| зЕгпаспр( ВЕ, $_еп91пебо0д1е, зг1еп(з_епд1пебоод1е))) { 
гефигп; 
} 
п_Тагдет. Мау1дате(увЕ, Ми, МИЦ, Розфбафа, №); 
*Сапсе] = ТНИЕ 
} 


\у019 СЕхо9Б\1ем: :ОпТ1{1еСпапдеЕхр1огег2 (ЕРСТУТВ Тех®) 
{ 
// Осторожно! Событие может быть получено раньше, 
// чем мы будем готовы. 
СМпа»* рипа = АРхбетАрр()->т_рМатпмпа; 
Те (р\па != МЕ) { 
ТЕ (: : Тэ\1пдом(рипа=>т_ИМпа)) { 
рмпа->5еИ1паомТехЕ(Тех+): 
} 


Обработчик ОпВеотеМалющеЕхрЬ/!отет1 вызывается, когда пользователь щел- 
кает ссылку на поисковой странице. Функция сравнивает ОВГ-адрес ссылки 
(в строковом параметре ИГ) с ОВТ-адресом поисковой системы. Если они со- 
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впадают, навигация продолжается в окне поиска, в противном случае она пре- 
кращается, и вызывается метод Мам!рае для целевого окна. Обработчик Ой1ТщЩе- 
СрапвеЕхрютет2 обновляет заголовок окна ЕхО9Ь в соответствии с заголовком 
целевой страницы. 

10. Соберите и протестируйте приложение Ех09Ъ. Выполните какой-нибудь 
поиск на странице Соозе, затем просмотрите информацию, появившуюся на 
целевой странице. 


Свойства-картинки 


Некоторые элементы управления АспуеХ поддерживают свойства-картинки (р/с- 
саге ргорепу), значениями которых могут быть растровые изображения, метафайлы 
и значки. Если у АсНуеХ-элемента есть хоть одно такое свойство, при установке 
данного элемента управления в проекте У15иа1 Знаю .МЕТ создаст класс СРёите. 
Вы не обязаны использовать его, но вынуждены применять МЕС-класс СРчите- 
Ноцег. Для доступа к объявлению и коду класса СРсштеНо!4ег добавьте в ${ЧАЁХ.В 
строку: 

Н1ис1иде <аРхст1. п> 


Допустим, у вас есть АсНуеХ-элемент со свойством-картинкой по имени Риге. 
Вот как инициализировать это свойство растровым изображением из ресурса: 


СР1сфигеНо1дег р1ст; 
р1ст. СгеафеРгомВ1тар( ТОВ_МУВТТМАР); // из ресурса проекта 
т_сопЕго1. ЗеЕРасфиге (р1с+. бетРасфигеб1зрафсн()); 


Примечание Подключив файл АЁХСИ.В, вы не сможете статически скомпоно- 
вать свою программу с МЕС-библиотекой. Чтобы создать автономную 
программу, поддерживающую свойства-картинки, вам придется позаим- 
ствовать код класса СРчитеНоет, содержащийся в файле Ше \Ргозгат 
Е|е5\Мсгозой У154а1 Знаю МЕТ\УС7\айтаЕс\згс\пас\сИрсЕсрр. 


Связываемые свойства: 
уведомления об изменении 


Если АсИуеХ-элемент имеет свойство, обозначенное как связываемое (Ба4аЫе), 
он посылает своему контейнеру уведомление ОпСрапвей при каждом изменении 
значения свойства внутри элемента управления. Кроме того, он может послать 
уведомление ОпКециея Ей для свойства, чье значение должно измениться, но пока 
этого не произошло! . Если контейнер вернет ЕАТЗЕ из обработчика ОпКедиеЕай. 
элемент управления должен отказаться от изменения значения свойства. 

МЕС полностью поддерживает уведомления об изменении свойств для контей- 
неров элементов АсйуеХ, однако в версии У15иа1 С++ МЕТ соответствующая под- 


‚ 


' Для этого свойство следует обозначить как «запрашивающее разрешение на обновле- 


ние» (гедиемеа!). — Прим. перев. 
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держка со стороны мастеров отсутствует. Это значит, что вам придется вручную 
добавлять записи в таблицу приема событий в классе контейнера. 

Допустим, у вас есть элемент управления АсИуех со связываемым свойством 
Мое, идентификатор которого равен 4. Тогда вы должны добавить в таблицу приема 
событий макрос ОМ_РКОРМОТИЕУ: 


ВЕСТМ_Е\ЕМТУТМК_МАР(САбои{019, С01а109) 
О№_РВОРМОТТЕУ (САБоит019, ТОС_МУСТНЕТ, 4, Оп№отейециез+Ед1т, 
Оп№теСпапдед) 
ЕМО_Е\УЕМТЗТМК_МАР() 


Затем вы должны написать код функций ОиМиеКедиеяЕ ай и ОпМоеСрапвеа, 
возвращаемые значения и параметры которых должны точно соответствовать 
следующим: 


800: СМу019: : Оп№отевеацезтЕа1 (ВОО » рб) 

{ 
ТВАСЕ( "СМу019 : : ОпМотеведие$+Е911\п”); 
*рб = ТВИЕ; // ТНЫЕ означает разрешение на изменение значения 
гетигп ТВОЕ 


} 


ВООЕ СМу019: :Оп№отеСпапдед() 

{ 
ТВАСЕ( "СМу019: : Оп№отеСпапдеа\п”); 
гетигп ТВИЕ; 


Соответствующие прототипы надо добавить в заголовочный файл класса: 


аРх_тз9 ВО0Е Опм№отеведезтЕаз{(ВООЕ» р); 
аРх_тз9 ВООЁЕ Оп№ теСпапдеа(); 


ГЛАВА 
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Управление памятью в \/п32 


ют истекшие годы М!сгозой УЛп4о\$ претерпела массу перемен. В конце 1980-х 
системная память стоила бешеных денег, и приходилось выжимать максимум воз- 
можного из каждого байта оперативной памяти. Переход на 32 разряда коренным 
образом изменил ситуацию. В \/п16 надо было выполнять массу дополнитель- 
ных операций при вызове функций управления памятью (вроде С/юбАйос и 
с/офаЦПос). Эти функции перенесены в \/л32, но исключительно из соображе- 
ний обратной совместимости. По сути же эти функции устроены совершенно 
иначе, да и появилось множество новых функций. 

Мы начнем эту главу с хорошей порции теории, в том числе расскажем о фун- 
даментальных функциях управления динамически распределяемой памятью, или 
кучей (Беар). Затем вы увидите, как операторы пе\ и Чееге языка С++ связывают- 
СЯ С «нижележащими» функциями управления кучей. Наконец, вы узнаете, как 
использовать функции для спроецированных в память файлов (тетогу-тарреа 
815), а также получите несколько советов по управлению динамически распре- 
деляемой памятью. Более глубоко основы и методы управления памятью в \/т352 
освещены в книге Джеффри Рихтера (}еЙтеу Вусриег) «Ргоргатиите АррИсацопз юг 
М1сгозой УЛп4о\з, Еоииь Еаюп» (Мсгозой Ргезз, 1995) (Джеффри Рихтер, «\Ип- 
Чо\$ для профессионалов: создание эффективных УЛп32-приложений с учетом 
специфики 64-разрядной версии \Лпдо%уз»: «Русская Редакция» — «Питер», М., 2001), 
в которой рассказано о УИЛшао\ 2000. 


Процессы и адресное пространство 


Прежде чем изучать управление памятью в УЛпао%5, надо понять, что такое про- 
цесс (ргосс$5). Если вы знаете, что такое программа, полдела сделано. Програм- 
ма — это ЕХЕ-файл, который можно запустить из \/шао\/з. После запуска програм- 
ма называется процессом. У процесса есть собственные память, описатели фай- 
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лов и другие системные ресурсы. Запустив две копии одной программы, вы полу- 
чите два отдельных процесса. УЛю4о\у$ ТазК Мапазег (Диспетчер задач УЛп4оу/з) 
(вызываемый щелчком правой кнопкой мыши панели задач) предоставляет деталь- 
ный список процессов, выполняемых в данный момент, а также позволяет «убить» 
(КШ), т.е. принудительно завершить процессы, переставшие отвечать на запро- 
сы. Программа $РУХХ (поставляемая в составе У15ча| За о) показывает взаимо- 
связи между процессами, задачами и окнами. 
ешь 
Примечание \/шп4о\5 ТазК Мапазег показывает исполняемые программы и 
активные процессы. На вкладке Ргосеззез (Процессы) показаны актив- 
ные процессы. У одного процесса (например, УЛпао\з Ехрюгег) может 
быть несколько основных окон, каждое из которых обслуживается от- 
дельным потоком, а у некоторых процессов окна нет вообще (о пото- 
ках см. главу 11). 


Примечание М!сгозой „МЕТ ЕгатехуогК обеспечивает новый, более мелкий 
уровень деления исполняемого кода — Аррроташ, или прикладные 
домены. С ними мы познакомимся поближе в главе 31. 


Важно знать, что процессу выделяется свое «частное» 4-гигабайтное виртуальное 
адресное пространство, о котором вы подробнее узнаете чуть позже, а пока во- 
образите, что у вашего компьютера оперативная память размером в сотни гига- 
байт и каждый процесс исправно получает свои 4 Гб. Программа может обращаться 
к любому байту этого адресного пространства, используя один-единственный 32- 
разрядный линейный адрес. При этом в адресном пространстве каждого процес- 
са содержится масса самых разных элементов: 

Ш образ ЕХЕ-файла программы; 

Ш все несистемные ОИ, загруженные вашей программой (в том числе РИ.-мо- 
дули МЕС); 

Ш глобальные данные программы (как доступные для чтения и записи, так и 
предназначенные только для чтения); 

Ш стек программы; 

Ш динамически выделяемая память, в том числе куча \Лп4о\з и куча библиоте- 

ки С периода выполнения (С гапите Ибгагу, СКТ); 

файлы, спроецированные в память; 

блоки памяти, совместно используемые несколькими процессами; 

локальная память отдельных выполняемых потоков; 


всевозможные особые системные блоки памяти, в том числе таблицы вирту- 
альной памяти; 


Ш ядро, исполнительная система и РИ-компоненты М/шпао%%5. 


Адресное пространство процесса в \Мтдомз 95/98 


В \шао\з 95 только нижние 2 Гб адресного пространства (0 — Ох7ЕРЕЕЕЕЕ) по- 
настоящему закрыты, причем доступ к нижним 4 Мб этих 2 Гб запрещен. Стек, кучи 
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и глобальная память, доступная для чтения и записи, проецируются на нижние 
2 Гб, как, впрочем, и ЕХЕ- с РЫ.-файлами приложения. 

Верхние 2 Гб совместно используются всеми процессами. Ядро УЛпаоу%$ 95, 
драйверы виртуальных устройств (Ухр), код файловой системы, а также таб- 
лицы страниц располагаются в верхнем гигабайте адресного пространства 
(0хС0000000 — ОхЕЕЕЕЕЕЕЕ). Динамически подключаемые библиотеки и спроеци- 
рованные в память файлы расположены в диапазоне 0х80000000 — ОхВЕЕЕЕЕЕЕ 
На рис. 10-1 показана схема распределения памяти двух процессов, исполняющих 
одну и ту же программу. 

Насколько все это безопасно? Посторонний процесс практически не в состо- 
янии перезаписать стек, глобальные данные или память кучи другого процесса, 
потому что вся память в нижних 2 Гб виртуального адресного пространства, при- 
надлежит одному процессу, и только ему. Весь код ЕХЕ- и РИ -файлов помечен 
как доступный только для чтения, поэтому нет никакой проблемы в том, что он 
спроецирован в несколько процессов. 

Однако верхний гигабайт адресного пространства весьма уязвим, ПОСКОЛЬКУ В 
него спроецированы важные данные УЛп9оууз, доступные для чтения и записи. При 
ошибке программа может уничтожить важные системные таблицы, расположен- 
ные в этой области. А какой-нибудь процесс может повредить содержимое спро- 
ецированных в память (0х80000000 — ОхВЕЕЕЕЕЕЕ) файлов, потому что эту область 
совместно используют все процессы. 


Адресное пространство МИпдомз МТ/2000/ХР 


Процесс в УЛп4о\уз МТ/2000/ХР имеет доступ только к нижним 2 Гб своего адрес- 
ного пространства, причем самые нижние и самые верхние 64 кб этого диапазо- 
на недоступны. Исполняемый файл, ОТ, приложения и \ХИт4о\уз, а также спрое- 
цированные в память файлы располагаются в диапазоне 0х00010000-Ох7ЕЕЕЕЕЕЕ 
Ядро, исполнительная система и драйверы устройств \/пао\$ МТ располагаются 
в верхних 2 Гб, где они полностью защищены от искажения со стороны неисп- 
равной программы. Файлы, спроецированные в память, также реализованы надеж- 
нее: никакой процесс не получит доступа к спроецированному в память файлу 
другого процесса, если только он не знает имени файла и не создал проекцию 
ЯВНО. 


Устройство виртуальной памяти 


Конечно, на самом деле никаких сотен гигабайт оперативной памяти в вашем 
компьютере нет. Нет и сотен гигабайт дискового пространства. Здесь У/по%\и 
показывает «ловкость рук» настоящего фокусника. 

Во-первых, 4-гигабайтное адресное пространство процесса экономно исполь- 
зуется небольшими фрагментами. Программы и элементы данных разбросаны по 
адресному пространству блоками по 4 кб, выровненными по границам, кратным 
4 кб. Каждый такой блок называется страницей (разе) и содержит либо код, либо 
данные. Естественно, используемая страница занимает какой-то участок физичес- 
кой памяти, но вы никогда не узнаете ее физического адреса. Микропроцессор 
фирмы ие! эффективно преобразует 32-разрядный виртуальный адрес в номер 


ГЛАВА 10 Управление памятью в \\п32 209 


физической страницы и смещение внутри нее, пользуясь двухуровневыми табли- 
цами 4-килобайтных страниц (рис. 10-2). Заметьте: отдельные страницы можно 
помечать либо как «только для чтения», либо как «для чтения и записи». Кроме того, 


Процесс А Диск Процесс В 
ОхЕРЕРЕЕЕЕ 
0хС0000000 
Совместно 
используемое 
пространство 
памяти 
0х80000000 
0х5Е400000 
0х10000000 
‚Глобальная память, 
| для чтения и записи 
0х00400000 


Рис. 10-1. Типичное распределение виртуальной памяти двух процессов, 
связанных с одним и тем же ЕХЕ-файлом в Утаоихз 95/98 
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эБз—жвььъъънж ооо» ___—_о_—_—_ 


у каждого процесса свой набор таблиц страниц, Регистр СКЗ процессора содер- 
жит указатель на страницу каталога, поэтому при переключении с одного про- 
цесса на другой УЛп9о\$ просто обновляет этот регистр. 


32-разрядное линейное пространство адресов 


ты 21-12 Физическая страница 


памяти 


Биты31-2 | 


Смещения 

внутри 

страницы 

Таблица страниц 


Каталог таблиц 
страниц 


20 разрядов 12 разрядов 


20 разрядов 12 разрядов 


Каждая запись таблицы страниц 
содержит биты чтения/записи 
и присутствия в физической памяти 


\ММпдо\м$ загружает СВЗ для текущего процесса 


Рис. 10-2. Управление виртуальной памятью в ИЙт32 (на процессоре тей) 


Итак, теперь объем пространства, занимаемого нашим процессом, сократил- 
ся с 4 Гб до, скажем, 5 Мб — прогресс налицо. Но если мы запустим несколько 
программ (помимо самой УЛп4о\з!), нам опять не хватит оперативной памяти. 
Еще раз обратившись к рис. 10-2, вы заметите, что запись таблицы страниц со- 
держит бит присутствия в физической памяти (ргезепи), который сообщает, на- 
ходится ли сейчас в физической памяти данная 4-килобайтная страница. При 
попытке обращения к странице, отсутствующей в памяти, инициируется преры- 
вание, и \/ш4оу/з анализирует ситуацию, просматривая свои внутренние табли- 
цы. Если ссылка на область памяти оказывается ошибочной, мы получим ненави- 
стное сообщение об ошибке страницы (разе а), и программа завершится. В про- 
тивном случае \Лп4о\уз считает в оперативную память нужную страницу из дис- 
кового файла и обновит таблицу страниц, записав в нее физический адрес и ус- 
тановив бит присутствия в физической памяти. Так работает виртуальная память 
в \1п32. 

Диспетчер виртуальной памяти УЛп4оу\уз, стремясь достичь максимума произ- 
водительности, определяет моменты чтения и записи страниц. Если какой-то 
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процесс не использовал страницу в течение определенного периода, а другому 
нужна память, страница выгружается из памяти, а вместо нее загружается стра- 
ница нового процесса. Обычно программа об этом не уведомляется. Но вы долж- 
ны понимать: чем интенсивнее дисковый ввод/вывод, тем ниже производитель- 
ность, вот почему всегда желательно иметь побольше оперативной памяти. 

Мы употребили слово «диск», но еще ничего не сказали о файлах. Все процес- 
сы совместно используют один большой общесистемный страничный файл (зар 
Не) (ранее он назывался файл подкачки), куда помещаются (при необходимос- 
ти) все виды данных для чтения и записи и некоторые виды данных только для 
чтения. (\И/ш4о\мз МТ/200/ХР способна одновременно поддерживать несколько 
страничных файлов.) Ил оуз определяет размер страничного файла в зависи- 
мости от объема ОЗУ и свободного дискового пространства, но есть способы 
тонкой настройки размера и физического расположения этого файла. 

Диспетчер виртуальной памяти, однако, использует не только страничный файл. 
Записывать в него страницы кода резона нет. Вместо этого \Лп4о\$ проецирует 
содержимое ЕХЕ- и РИ-модулей прямо в их дисковые файлы. Поскольку страни- 
цы кода помечены «только для чтения», необходимости в их записи обратно на 
диск не возникает. 

Если два процесса используют один и тот же ЕХЕ-файл, последний отобража- 
ется на адресные пространства обоих процессов. Код и константы никогда не 
изменяются во время выполнения программы, поэтому можно проецировать файл 
на одну и ту же область физической памяти. Однако два процесса не могут со- 
вместно обращаться к глобальным данным. С ними \/т4о%5 95/98 и УЛпаоу\уз МТ/ 
200/ХР поступают по-разному. УЛп4о\з 95/98 проецируют в каждый процесс от- 
дельную копию глобальных данных, а вот в \/по\з МТ/200/ХР оба процесса 
используют одну копию глобальных данных до тех пор, пока один из процессов 
не попытается что-либо записать в страницу. В этот момент страница копирует- 
ся, а затем у каждого процесса появляется собственная копия, находящаяся по 
одинаковому виртуальному адресу. 


Примечание Динамически подключаемая библиотека проецируется непосред- 
ственно на свой файл РЦ, только если ОИ.-модуль удается загрузить по 
заданному базовому адресу. Если РИ; статически скомпонована для за- 
грузки по адресу, скажем, 0х10000000, а этот диапазон адресов уже за- 
нят другой РИ, УИл4оуу$ нужно «урегулировать» адреса в самом коде РМ. 
'УИпао\5 МТ/200/ХР копируют модифицированные страницы в странич- 
ный файл при первичной загрузке ОИ, а УЛп4о\з 95/98 выполняют на- 
стройку адресов «на лету» при копировании страниц в память. Стоить 
ли говорить о том очевидном факте, что в ваших РИ. диапазоны адресов 
не должны перекрываться? Если вы применяете ОИ.-модули МЕС, устано- 
вите базовый адрес своих РМ, вне диапазона 0х5Е400000-Ох5ЕЕЕЕЕЕЕ 
Подробнее о том, как писать О, мы поговорим в главе 20. 


Файлы, проецируемые в память, которые мы обсудим позже, также отобража- 
ются напрямую. Их можно определить как доступные для чтения и записи или 
совместно используемые несколькими процессами. 
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нта данных нижние 16 кб, УЛп- 
амым младшим адресам, вы _ 
весьма полезно, ког- _ 


удущего с помощью сегментов и обойдет 


Функция Итша/АГос: 
переданная и зарезервированная память 


Если вашей программе нужна динамически распределяемая память, то рано или 
поздно придется вызвать \/132-функцию УййииАйос. Скорее всего делать это будете 
не вы, а функции \/Лп9о\5$ или библиотеки С периода выполнения, выделяющие 
память из кучи. Но зная, как работает УтиАЙос, вы лучше поймете функции, 
которые к ней обращаются. 

Сначала разберемся с понятиями зарезервированная (гезегуеа) и передамная 
(сотпицеа) память. При резервировании памяти выделяется непрерывный диа- 
пазон виртуальных адресов. Если вы, допустим, знаете, что программа будет опе- 
рировать с одной 5-мегабайтной областью памяти [области памяти иногда назы- 
вают регионами (гез1опз)], но вся она вам сейчас не нужна, вызовите УйтиеАйос и 
в параметре, определяющем тип выделения памяти, укажите МЕМ_КЕЗЕКУЕ, а в 
параметре, задающем размер выделяемой памяти, — 5 Мб. \Лпао\у$ округляет на- 
чальный и конечный адреса области до значений, кратных 64 кб, и уже не даст 
вашему процессу повторно зарезервировать память из этой области. И, хотя можно 
указать начальный адрес области, лучше оставить это занятие самой УЛАпао\5. 
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Ну вот, собственно, и все на этом этапе. Больше ничего не происходит: не выде- 
ляются ни оперативная памяти, ни пространство в страничном файле. 

Когда вам действительно понадобится оперативная память, вы снова вызовете 
ИтиАйЙос, указав на этот раз МЕМ_СОММИТ, чтобы передать память из этой обла- 
сти. Теперь начальный и конечный адреса блока округляются до значений, крат- 
ных 4 кб, и в страничном файле выделяются соответствующие страницы, а также 
создается нужная таблица страниц. Блок помечается либо «только для чтения», либо 
«для чтения и записи». Однако физическая память по-прежнему не выделяется — 
это произойдет, лишь когда вы попытаетесь получить доступ к этому блоку памя- 
ти. Ничего страшного, если передаваемая память ранее не была зарезервирована 
или была передана — главное, что перед использованием память следует передать. 

Для возвращения (Ааесоти!) переданной память (по сути возврата соответству- 
ющим страницам статуса зарезервированных) применяется функция ИУтиеЕтее. 
Она может также освободить зарезервированную область памяти, но для этого ей 
надо передать базовый адрес, возвращенный предыдущим вызовом УйиеАйЙос при 
резервировании памяти. 


Куча МИпдом$ и семейство функций С/оба!Аос 


Куча (пеар) — это пул памяти какого-либо процесса. Когда программе нужен блок 
памяти, вы вызываете функцию, выделяющую память из кучи, а чтобы освободить 
память — функцию, выполняющую обратное. Выравнивания по границам, крат- 
ным 4 кб, при этом не происходит — диспетчер кучи использует пространство 
на выделенных страницах или обращается к УЙи@ИАЦос за дополнительными 
страницами. Сначала мы познакомимся с кучами \У/Лп9о\5, а затем — с куча- 
ми, управляемыми библиотекой С периода выполнения, в частности функциями 
тайос и пеш. 

УЛпаоу$ предоставляет каждому процессу кучу по умолчанию, а процесс мо- 
жет создать любое число дополнительных куч \Лп9о%5. Для выделения памяти из 
куч УЛюаоууз служит функция НеарАЙос, а для освобождения — НеарЕтее. 

Скорее всего вы не будете вызывать НеарАЙос — за вас это сделает унаследо- 
ванная от \/1116 функция С/юбИЙос. В идеальном мире 32-разрядных программ 
вам не понадобилась бы СюБаШос, но мы живем в реальном мире. У нас все еще 
остается колоссальный объем кода, перенесенного из \/1п16, в котором вместо 
32-разрядных адресов применяются параметры типа «описатель памяти» (НОТОВАГ,). 

Соб Йос использует кучу \Лп4о\з по умолчанию. Работа этой функции за- 
висит от передаваемых ей атрибутов. Если указать СМЕМ_ЕХЕБР, она просто вы- 
зывает НеарАПос и возвращает адрес, приводя его к 32-разрядному значению 
НОГОВАГ. Если же вы передаете СМЕМ_МОУЕАВГЕ, возвращаемое значение НОГОВАЕ, 
является указателем на элемент таблицы описателей данного процесса. В этом 
элементе содержится указатель на память, выделенную функцией НеарАЙос. 

Зачем нужна иеремещаемая (тоуеаЫе) память, если она вводит в управление 
памятью еще один промежуточный слой? Здесь мы встречаемся с наследием \/1п16, 
где ОС действительно перемещала блоки памяти. В \/132 перемещаемые блоки 
памяти существуют лишь для поддержки С/юфЖеАЙос, которая выделяет новый блок 
памяти, копирует в него содержимое старого блока, освобождает последний и по- 
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мещает адрес нового блока в существующий элемент таблицы описателей. Если бы 
никто не вызывал СюбКеАЙос, мы могли бы обойтись НеарАЙос вместо СобАЙос'. 

К сожалению, многие библиотечные функции используют в качестве параметров 
и возвращаемых значений НОГОВАГ, а не адреса памяти. Если такая функция воз- 
вращает НОГОВАЕ, вы должны считать, что память выделена с атрибутом СМЕМ _МО- 
УЕАВГЕ, и, следовательно, чтобы получить адрес памяти, надо вызвать функцию 
СТобаПосЕ. (В случае фиксированной памяти СюфаЦосе просто возвращает пере- 
данный сй описатель как адрес.) По завершении работы с памятью ее освобожда- 
ют вызовом Сюфатосе. Если вы должны передать параметр НОГОВАГ, то для 
верности следует получить это значение с помощью СТоБаИос(СМЕМ_МОТУЕ- 
АВГЕ,..) — на случай, если вызываемая функция обращается к СюБКеАйос и ожи- 
дает, что значение описателя не изменится. 


Куча малых блоков, _пеартт 
и операторы леи/ и ае!е!е в С++ 


Вы вправе применять НеарАйос, но скорее всего вы будете работать с функциями 
тайос и рее библиотеки С периода выполнения. Если же вы программируете на 
С++, то будете работать с операторами пеш и де/еге, напрямую вызывающими 77а/ос 
и Ле. Если с помощью пеш выделяется блок, превышающий определенный пре- 
дел (по умолчанию 480 байт), то СВТ (С++ гапите ИБгагу) сразу передает вызов 
функции НеарАЙос — для выделения памяти из кучи УЛп4о\у$, созданной для СВТ. 
Блоками, меныпими указанного предела, управляет сама СВТ с помощью кучи малых 
блоков (зтаП-Ыоск Веар), вызывая при необходимости ИйиеиАйос и утищЕтее. 
Алгоритм работы таков. 


Память резервируется областями по 4 Мб. 

2. Память передается блоками по 64 кб (16 страниц). 

3. Память возвращается по 64 кб за раз. Если освобождается 128 кб, то возвраща- 
ются последние 64 кб. 


4. 4-мегабайтная область освобождается, когда возвращены (4есотпицеа) все ее 
страницы. 


Как видите, куча малых блоков сама занимается очисткой. А вот куча УЛп49о\$ 
автоматически не возвращает страницы и не отказывается (ипгезегуе) от них. Для 
очистки больших блоков нужна СЕТ-функция _беарти, которая вызывает функ- 
цию Ут 9оу$ НеарСотрасе. (Увы, версия НеарСотрас! для УЛпао\уз 95 /98 не де- 
лает ничего — еще один довод в пользу УЛпао\з №Т/2000/ХР) Как только стра- 
ницы возвращены, другие программы могут обратиться к освободившемуся про- 
странству страничного файла. 


' Очень спорное утверждение. Во-первых, для копирования данных в буфер обмена 


(сИрБоага) нужно выделить блок памяти вызовом С/юбеАйос с атрибутами 
СМЕМ_МОТЕАВЕЕ и СМЕМ_ОРЕЗНАКЕ. Во-вторых, выделение памяти с атрибутом 
СМЕМ_МОУТЕАВЕЕ позволяет системе перемещать блоки памяти внутри кучи, тем са- 
мым не допуская ее фрагментации. — Прим. перев. 
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Примечание В предыдущих версиях СКТ указатели списка свободных блоков 
памяти хранились в страницах самой кучи. Такой подход требовал от 
та[ос в поисках свободного пространства «перелистывать» (считывать 
из страничного файла) множество страниц, что снижало производитель- 
ность. Современная система, хранящая список свободных блоков в от- 
дельной области памяти, работает быстрее и уменьшает необходимость 
в дополнительном ПО для управления кучей. 


Если вы хотите узнать или изменить предельное значение размера блока, ис- 
пользуйте СВТ-функции _5еЁ 56р_тезро@ и _веё 56р Штезром. 

Специальная отладочная версия тайос — _тайос_@6е — записывает в выделя- 
емые блоки памяти отладочную информацию. _тайос арб вызывается операто- 
ром ие», когда вы собираете МЕС-проект с определенным символом _РЕВОС. При 
этом программа может обнаружить блоки памяти, которые вы забыли освободить 
или нечаянно затерли. 


Проецируемые в память файлы 


Если вы думаете, что у вас недостаточно возможностей управления памятью, рас- 
смотрим еще один вариант. Допустим, программа должна считывать П!В-файл 
(Ремсе-шаерепаепе Витар — растровое изображение в аппаратно-независимом 
формате). Очевидное решение — выделить буфер нужного размера, открыть файл 
и вызвать функцию чтения, чтобы целиком скопировать дисковый файл в буфер. 
Но куда элегантнее спроецировать файл в память, т. е. просто отобразить диапа- 
зон адресов прямо на файл. Когда процесс обращается к какой-то странице па- 
мяти, УЛи4оу\5 выделяет область оперативной памяти и считывает данные с дис- 
ка. Код выглядит примерно так: 


НАМОЕЕ НЕ1]е = : :Сгеатер11е(з{гРа{Ппате, СЕМЕВТС_ВЕАЩ, 
ЕТ1Е_ЗНАВЕ_ВЕАО, №, ОРЕМ_ЕХТУТТ№ , ЕТЕЕ_АТТАТВУТЕ_МОВМАЕ, МЕ); 
АЗЗЕВТ (ИЕ11е != МЕ); 
НАМОСЕ ВМар = ::СгеафеЕ11еМарр1пд9(1Е11е, М, РАСЕ_ВЕАБОМУ, 
0, 0, МЫ); 
АЗУЕВТ(ПМар != МЕ); 
ЕРУОТО 1руЕ11е = ::Мар\1емотЕ11е(пМар, РТЕЕ_МАР_ВЕАВ, 
0, 0, 0); // Проецируем целый файл 
ОМОВО 9мЕ11е317е = ::@бе{Е11е512е(пР11е, №11); // полезная информация 
// Файл используется 
: /птар\1емотЕ11е(1р\уЕ11е); 
: :С10озеНапа1е(ПМар); 
: :С1озеНапд1е(пЕ11е); 


Здесь используется виртуальная память, содержимое которой хранится в ОВ- 
файле. УЛиао\з определяет размер файла и передает соответствующую область 
виртуальной памяти. В данном ‘случае ее начальный адрес — роЕйе. Переменная 
РМар содержит описатель объекта «проекция файла», к которому могут совмест- 
но обращаться несколько процессов. 

О1В-файл в этом примере невелик, поэтому его можно полностью считать в 
буфер. Но представьте себе файл большего размера, с которым обычно работают 
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с применением команд поиска (зееК). Файлы, проецируемые в память, будут ра- 
ботать и с таким файлом благодаря системе виртуальной памяти, лежащей в их 
основе. Память выделяется, и страницы читаются, только когда к ним обращают- 
ся, и не раньше. 
И 
Примечание По умолчанию файл проецируется целиком, хотя можно проеци- 


ровать лишь его часть. 
мБжЩщ 


Если два процесса совместно обращаются к объекту «проекция файла» (ска- 
жем, БМар, как в предыдущем примере), то файл по сути становится совместно 
используемой памятью; но виртуальные адреса, возвращаемые МариешО]ЕЕ, могут 
различаться. Именно таков предпочтительный способ совместного использова- 
ния памяти в №1132. (Вызов функции СюбаАйос с флагом СМЕМ $НАКЕ не созда- 
ет совместно используемую память, как было в \/1016.) Если вам нужно только 
совместное использование памяти, а постоянный дисковый файл не требуется, 
можете не вызывать СуешеЕйе, а передать функции СуешеЕйеМарртв в параметре 
БЕЙе значение ОхЕЕЕЕЕЕЕЕ Тогда содержимое совместно используемой памяти будет 
храниться в страницах страничного файла. (Подробности — в книге Джеффри 
Рихтера). 
ан 
Примечание Если вам нужен произвольный доступ к небольшому числу стра- 

ниц спроецированного в память файла, основанного на страничном 
файле, используйте прием, описанный Джеффри Рихтером. В этом слу- 
чае СтешеРйеМарртя вызывается со специальным флагом, а затем с по- 
мощью УййииАЦос передаются только заданные диапазоны адресов. 


зонами 

Примечание Обратите внимание на сообщение У/пао\з УМ_СОРУПАТА. Оно 
позволяет процессам обмениваться данными через совместно исполь- 
зусмую память, не обращаясь к АР!-функциям, применяемых для рабо- 
ты с проецируемыми файлами. Это сообщение является синхронным, т.е. 
процесс-отправитель должен подождать, пока процесс-получатель ско- 
пирует и обработает данные. 


К сожалению, МЕС не поддерживает проецирование файлов или совместное 
использование памяти напрямую. Класс С5ратедЕйе поддерживает только обмен 
данными через буфер обмена (сйрБоага) при помощи описателей НСТОВА!, так 
что этот класс не настолько универсален, как может показаться из названия. 


Доступ к ресурсам 


Ресурсы содержатся в ЕХЕ- или ОИ-файлах и, таким образом, занимают вирту- 
альное адресное пространство, содержимое которого не меняется в течение жизни 
процесса, поэтому ресурсы легко читать напрямую. Если вам, допустим, нужен 
доступ к растровому изображению, адрес ГВ позволяет получить примерно та- 
КОЙ КОД: 


ЕРУОТВ 1руВезоигсе = (1РУОТО) : : [оадВезоигсе (МИ, 
: : РАпдВезоигсе(МУГЕ, МАКЕТМТВЕЗОУНСЕ( ТОВ_ВЕОВЕОСКУ), ВТ_ВТТМАР)); 
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Функция Гоа Кезоитсе возвращает значение НСТОВАТ, но его можно безопас- 
но приводить к указателю. 


Советы по работе с кучей 


Чем интенсивнее используется куча, тем больше она фрагментируется и тем мед- 
леннее работает программа. Если время непрерывного функционирования про- 
граммы будет исчисляться часами или днями, следует проявить особую осторож- 
ность. Лучше выделить всю нужную память при запуске программы и освободить 
при закрытии, но это не всегда возможно. Тут может помешать класс С5Ип9, ко- 
торый постоянно выделяет и освобождает крошечные порции памяти. 

Не забывайте вызывать _реарпит каждый раз, когда программа выделяет бло- 
ки размера, превышающего верхний предел для кучи малых блоков. Следите за 
тем, откуда получена динамически распределяемая память: у вас возникнут жут- 
кие проблемы, если, скажем, вы вызовете НеарЕгее, передав ей указатель на ма- 
лый блок, полученный от пеш. 

Учтите: размер стека может быть практически любым. Так как ограничения в 
64 кб теперь нет, в стек можно помещать объекты большого размера, что умень- 
шает необходимость в распределении памяти из кучи. 

Ваша программа, работая на полной скорости, не сгенерирует исключение, если 
УЛпао\$ не хватит страничного файла. Она просто станет постепенно замедляться 
и вконце концов остановится; что вряд ли понравится пользователю. Здесь от вас 
мало что зависит — можно лишь пытаться определить, какая программа пожира- 
ет память и почему. Поскольку в модулях СП! и О5ЕВ УЛпаоуз$ 95/98 по-прежне- 
му есть 16-разрядные компоненты, сохраняется вероятность переполнения 64- 
килобайтных куч, хранящих объекты СПГ и оконные структуры. Однако такая 
вероятность крайне мала, и если дела обстоят именно так, то ошибка скорее все- 
го в вашей программе. 


Оптимизация хранения констант 


Вспомните, что код вашей программы хранится не в страничном файле, а прямо 
в ЕХЕ- и ОИ -файлах. Если запущено сразу несколько экземпляров программы, на 
виртуальные адресные пространства каждого процесса будут спроецированы те 
же ЕХЕ и РЦ. Но что при этом происходит с константами? Предпочтительнее, 
чтобы они были частью программы, а не копировались в другой блок виртуаль- 
ной памяти, хранимый в страничном файле. 

Чтобы константы гарантированно хранились вместе с программой, придется 
поработать. Во-первых, обратите внимание на строковые константы, которыми 
часто изобилуют программы. Может, вы решили, что они будут данными «только 
для чтения»? Не совсем — пошевелите-ка еще раз извилинами. Действительно, вы 
имеете право написать что-то вроде: 
спаг* рсй = "1езт"; 


*рсй = ‘Хх’; 


Но {е% не может быть константой. Чтобы строка стала константой, ее надо 
соответственно объявить и инициализировать, скажем, так: 


сопз+ спаг 9_рсп[] = "фезт”; 
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Теперь 8_рсь хранится вместе с кодом. Но где именно? Чтобы ответить на этот 
вопрос, надо знать о секциях данных (ага зесйоп5), генерируемых компоновщи- 
ком У15ца! С++. Если потребовать от компоновщика, чтобы он генерировал файл 
компоновки (тар Ше), то в последнем вы найдете длинный список секций (бло- 
ков памяти) вашей программы. Отдельные секции могут предназначаться для 
хранения кода или данных, а также помечаться «только для чтения» или «для чте- 
ния и записи». Вот основные секции и их характеристики: 


Табл. 10-1. Важные секции программы 


Имя Тип Доступ Содержимое 
деж Код Только чтение Код программы 
та Данные — Только чтение Инициализированные константы 


„Ча Данные Чтение и запись  Инициализированные данные (не константы) 
655$ Данные Чтение и запись  Неинициализированные данные (не константы) 


Секция г4а(а — часть ЕХЕ-файла; именно сюда компоновщик поместит пере- 
менную & рр. Чем больше данных вы поместите сюда, тем лучше. Для этого слу- 
жит модификатор соп5. В секцию гАаа можно включить встроенные типы и даже 
структуры, но не объекты С++, у которых есть конструктор. Если написать оператор: 


сопз{ СВесф 9_гест(0, 0, 100, 100); 


компоновщик внесет этот объект в секцию .555, а в страничном файле будет вы- 
делено место для хранения отдельной копии объекта для каждого процесса. Если 
хорошенько подумать, то так и должно быть, потому что компилятор вызывает 
функцию-конструктор после загрузки программы. 

А теперь допустим, что вы собираетесь сделать худшее — объявить глобальную 
переменную (или статическую переменную-член класса) типа С5йтв вроде: 


сопзф С$4г1п9 9_$1г(”{11$ 1$ Тпе могзф {1119 Т сап 90"); // хуже не придумаешь 


Вы получите объект С5#тв, размер которого весьма мал, в секции 15$ и мас- 
сив символов в секции .аа. Ни тот, ни другой не могут храниться в ЕХЕ-файле в 
период выполнения. Хуже того, при запуске программы класс Сие должен вы- 
делить память из кучи для хранения копии массива символов. Так что в данном 
случае вместо объекта С5й7и8 лучше задействовать соп5{-массив символов. 
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Обработка сообщений 
\ММпаом$ и многопоточные 
приложения 


Кажиниах многозадачность и многопоточность в \/Лю32 произвели настоя- 
щую революцию в программировании для УЛюао\%5. Если вам попадались статьи 
или книги по этим вопросам, вы наверняка уже оценили всю сложность приме- 
нения многих потоков. Вообще-то вы еще долго сможете разрабатывать полез- 
ные однопоточные У/Лп9о\5-приложения. Но изучив основы многопоточности, 
вы сможете создавать более эффективные и мощные программы и лучше разбе- 
ретесь в модели программирования \/1п32. 


Обработка сообщений \/Итдом$ 


Чтобы разобраться в потоках, сначала надо понять, как 32-разрядная \/шо\$ 
обрабатывает сообщения. Лучше всего начать с однопоточной программы, кото- 
рая продемонстрирует значимость процесса преобразования и рассылки сообще- 
ний. Затем мы усовершенствуем ее, добавив поток, управляемый с помощью гло- 
бальной переменной и простого сообщения. Потом поэкспериментируем с собы- 
тиями и критическими секциями. А чтобы вникнуть в более сложные элементы, 
обеспечивающие многопоточность (такие как мьютексы и семафоры), вам при- 
дется обратиться к другой книге, например, к уже упоминавшемуся труду Джеф- 
фри Рихтера. 


Обработка сообщений в однопоточной программе 


До сих пор мы писали только однопоточные (зте-@геа4еа) программы, т. е. у 
кода был лишь один поток исполнения. Используя мастер М1сгозой У150а1 5410, 


220 Часть | Основы МЕС 


вы создавали функции-обработчики различных сообщений \/1п4о\5, а также 
писали код функции Оп)тга, вызываемой в ответ на сообщение УМ _РА/МТ. Каза- 
лось бы, при появлении сообщения каким-то чудом вызывается соответствующий 
обработчик, но все не так просто. Глубоко в недрах МЕС-кода, компонуемого с 
вашей программой, спрятаны примерно такие инструкции: 


М5@ теззаде; 

мп11е (::бе{Меззаде( 8теззаде, МЕ, 0, 0)) { 
: : Ггапз1афеМеззаде (&теззаде); 
: : О1зратспМеззаде ( &теззаде); 


УЛпао\з определяет, какие сообщения принадлежат вашей программе, а функ- 
ция Се Ме5зазе возвращает управление, как только появляется сообщение для 
обработки. Если сообщений нет, ваша программа приостанавливается, и выпол- 
няются другие приложения. Когда сообщение наконец поступает, ваша програм- 
ма «пробуждается». Функция апящеМе5заве преобразует сообщения УМ _КЕУРОММУ 
в сообщения УМ_СНАК, содержащие А$СП-символы, а ОёрейсЬМе5засе передает 
управление (через оконный класс) коду выборки сообщений МЕС, который вы- 
зывает вашу функцию на основе таблицы обработчиков сообщений. Завершив 
работу, обработчик возвращает управление МЕС-коду, что в итоге вызывает воз- 
врат из ОйбраюкрМезаюе. 


Передача управления 


А что, если одна из ваших функций-обработчиков окажется «свиньей», алчущей 
процессорных ресурсов, и израсходует 10 секунд процессорного времени? Во 
времена 16-разрядной системы компьютер просто завис бы на это время. Доступ- 
ными остались бы только перемещение курсора мыши да пара-тройка других задач, 
управляемых прерываниями. В \/п352 многозадачность организована куда лучше. 
Вытесняющая многозадачность не даст другим приложениям зависнуть: \/п9о\, 
когда сочтет это нужным, просто приостановит выполнение «жадной» функции. 
Однако даже в \/1п32 на эти 10 секунд программа будет заблокирована. Она не 
сможет обрабатывать сообщения, так как ОбрасЬМе$засе не возвратит управле- 
ние, пока его не возвратит злополучный обработчик. 

Однако обойти эту проблему можно, причем как в \/1п16, так и в Х/1п32. Надо 
просто заставить «жадину» вести себя дружелюбнее, т.е. периодически отдавать 
управление — а для этого нужно вставить в основной цикл такой функции опе- 
раторы: 


М5@ теззаде; 

11 (::РееКМеззаде (&пеззаде, МИ, 0, 0, РМ_ВЕМОМЕ)) { 
:: Тгапз1атеМеззаде (&теззаде); 
: : 015рафспМеззаде ( &пеззаде); 


Функция РееЕМе5заве работает так же, как и Се!Ме5засе за исключением того, 
что возвращает управление сразу, даже в отсутствие соответствующих сообщений. 
При этом «свинская» функция продолжает поглощать процессорное время. Но стоит 
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появиться сообщению, вызывается обработчик, и по завершении его работы вы- 
полнение функции возобновляется. 


Таймеры 


Таймер \/пао\з — это полезный элемент, иногда устраняющий необходимость 
в многопоточном программировании. Например, если вам нужно считывать со- 
держимое коммуникационного буфера, установите таймер так, чтобы выбирать 
накопившиеся символы каждые 100 мс. Таймер можно применять и для управле- 
ния анимацией, поскольку он не зависит от тактовой частоты процессора. 

Работать с таймерами легко. Вы просто вызываете функцию СУпа::5е тег с 
параметром — интервалом времени, после чего определяете обработчик сообщения 
УМ _'ПИМЕК. После запуска таймера с заданным интервалом в миллисекундах со- 
общения УМ `ИМЕК постоянно посылаются вашему окну, пока не будет вызвана 
СсУпа.:КШГтег или уничтожено окно. Можно задействовать и несколько тайме- 
ров, каждый из которых идентифицируется целым числом. Поскольку УЛп90\$ 
не является ОС реального времени, точность соблюдения интервала длительнос- 
тью, значительно меньшей 100 мс, будет невысока. 

Как и другие сообщения \УЛп4о\з, сообщения таймера могут заблокировать 
другие функции-обработчики в вашей программе. К счастью, сообщения тайме- 
ра не аккумулируются. УЛп4о\у$ не ставит сообщения таймера в очередь, если в 
ней уже есть одно сообщение от данного таймера. 


Пример Ех11а 


Мы напишем однопоточную программу с циклом, в котором выполняется боль- 
шой объем вычислений. Программа должна обрабатывать сообщения после того, 
как пользователь приступит к вычислениям, иначе он не сможет прервать их. Кроме 
того, нам хотелось бы отображать процент выполненной работы, применив эле- 
мент управления «индикатор хода процесса» (рис. 11-1). Программа Ех! 1а обес- 
печивает обработку сообщений, передавая управление в цикле вычислений. Об- 
работчик таймера обновляет индикатор в соответствии с продвижением процес- 
са вычислений. Если бы процесс вычислений не передавал управление, нам не 
удалось бы обработать сообщения ЯМ_ТИМЕК. 


Рис. 11-1. Диалоговое окно Сотрше 


Итак, разработаем приложение Ех11а. 


1. Используя МЕС АррИНсаНоп У/1гаг4, создайте. проект Ех11а. Выберите в 
меню ЕЙе последовательно команды № \ и Рго]есе. В качестве типа приложе- 
ния выберите МЕС АррИсаЧцоп, а в качестве имени — Ех11а. На странице АррИ- 
саНоп Туре мастера установите переключатель в положение пе аосштепь, а 
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на странице Аауапсе4 Реагагез сбросьте флажок РипИпе апа рипе ргеме\. 
Остальные параметры оставьте без изменения. 

2. В редакторе диалоговых окон создайте диалоговый ресурс ШО_СОМРОТЕ. 
Выберите в меню Рго]ес! среды разработки команду АЯ Везоигсе и в открыв- 
шемся одноименном диалоговом окне щелкните строку 012108, а затем — кнопку 
М уу. У!5иа! Знаю создаст новый диалоговый ресурс. Измените идентифика- 
тор ресурса на /2О_СОМРИТЕ, а свойство Сарцйоп — на Сотрще. Измените 
идентификатор кнопки ОК на /0С_5ТАКТ, а свойство СарНоп — на ап. У кнопки 
Сапсе! измените идентификатор на 2С_САМСЕГ. Через панель инструментов 
Тоофох добавьге в окно индикатор хода процесса (Ргоэгез$ Сопго!) и оставь- 
те идентификатор по умолчанию /2С_РКОСКЕ$$1. По завершении этих опера- 
ций диалоговое окно должно выглядеть так: 


3. Средствами МЕС (1а$$ УЛтаг4 создайте класс ССотршеШю. В меню Рго}еси 
выберите команду АЧА С!а5$$ и в открывшемся окне МЕС С!аз5 УЙгага введите 
имя класса ССотршще[®, в качестве базового класса выберите СРёов и в поле 
Гаю Ш выберите П2р_СОМРИТЕ, чтобы связать новый класс с созданным 
диалоговым ресурсом. 

4. Создайте обработчики сообщений УМ_ИМЕК и ВМ СИСКЕО. Выберите 
класс ССотршер в С!а5$ У1еу, в окне Ргорегиез щелкните кнопку Меззаес$ и 
добавьте функцию ОпТйтег для сообщения ИМ_11МЕК. Щелкните кнопку Еуеп!$ 
и добавьте функции ОиВиСИсвеа$ат и ОпВпСИскеаСапсе! для ШС _5ТАКТ и 
12С_САМСЕЕ 

5. Добавьте три переменных-члена в класс ССотршеЛ. Отредактируйте 
файл СотршеП[®.5, добавив закрытые переменные-члены: 


ргамате: 
11 м_пГ1мег; 
11 м_пСоцп*; 
епит { пМахСоипт = 50000 }; 


Переменная-член т_иСоити класса ССотршеГ\® будет увеличиваться в про- 
цессе выполнения вычислений. Деление ее на константу иМахСоитЕ даст еди- 
ницу измерения продвижения. 

6. Добавьте код инициализации в конструктор ССотрше 1? в файле Сот- 
ршеП.срр. Напишите в конструкторе следующую строку (чтобы кнопка Сапсе! 
действовала, если вычисления еще не начаты): 


т_пСоипЕ = 0; 
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7. Запрограммируйте функцию ОпВиСИсвеаЯат в файле Сотрше[]з.срр. 
Этот код исполняется, когда пользователь щелкает кнопку 5"аг(. Добавьте вы- 
деленный код: 


\019 ССотрите019: :ОпВпС11скеад$Тагт() 
{ 


№56 теззаде; 


п_пТ1тег = $е{Т1тег(1, 100, №11); // 1/10 секунды 
АЗЗЕВТ(т_пТ1мег != 0); 
бе1019Т+ет( ТОС_$ЗТАВТ)->Епаб1е\1 пдом( РАЕЗЕ); 
\01а{11е 1п{ пТемр; 
Рог (т_пбоипф = 0; м_пСоипЕ < пМахСоипе; т_пСоип{++) { 
Тог (пТешр = 0; пТетр < 10000; пТетр++) { 
// чзез ир СРУ сус1ез 
} 
11 (::РееКМеззаде(&теззаде, МИГ, 0, 0, РМ_ВЕМОМЕ)) { 
: : Тгапз1атеМеззаде ( &меззаде); 
: : ОтзрафспМеззаде ( &теззаде); 
} 
} 
бе+019Т+ет(ТОС_$ТАВТ)->Епаб1е\1пдом( ТНИЕ); 
С01а109: : Оп0К(); 


Основной цикл /юг контролируется счетчиком 77_пСоити. На каждой итерла- 
ции цикла РееМез5аве позволяет обрабатывать другие сообщения, в том чис- 
ле УМ_'ИМЕЕ. Вызов Епаетаои(ЕАГЗЕ) отключает кнопку 5аге на время 
вычислений. Без этой меры предосторожности возможен повторный вызов 
функции ОпВиСисвеа$ ют. Повторный вызов функции ЕпаМетаоих(ТКИЕ) 
включает кнопку ${аг(, чтобы пользователь смог запустить таймер снова. 


8 Запрограммируйте функцию ОнТйпег в Сотрше01$.срр. При срабаты- 
вании таймера показание индикатора устанавливается в соответствии со зна- 
чением 772 иСоит. Добавьте выделенный код: 


\019 ССотрите019: :ОпТ1мег(0ТМТ птОЕ\епт) 

{ 
СРгодгеззС+г1* рВаг = 
(СРгодгеззС+г1*) бет019Т1ет( ТОС_РВО6ВЕ$$ 1); 
рВаг->5е{Роз(т_пСоип{ * 100 / пМахСоипт); 


С01а109: : ОпТ1мег(пТОЕмепт*); 
} 


9. Модифицируйте функцию ОнВиСИсвеаСапсе в Сотрие[П.срр. При 
щелчке пользователем кнопки Сапсе! в процессе вычислений мы не уничто- 
жаем диалоговое окно, а присваиваем 7т_иСоит максимальное значение, в 
результате функция ОпВиСйсвей$ т закрывает диалоговое окно. Если вычис- 
ления не начаты, диалоговое окно можно закрыть напрямую. Добавьте выде- 
ленный код: 
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уота ССотрите019: : ОпВпС11скеабапсе1 () 
{ 
ТВАСЕ( “епфег1п9 ССотри{е019: : ОпВпС11скед9Сапсе1\п"); 
1 (_пбоипЕ == 0) { // до нажатия кнопки З+аг+ 
С01а109: : ОпСапсе1(); 
} 
е1зе { // идут вычисления 
п_пСоипЕ = пМахбоипт; // принудительное завершение ОпВпС11скеа$таг+ 
} 
} 


10. Отредактируйте класс СЕх11аеи; в Ех11а\У1еуу.срр. Измените виртуаль- 


1 


ную функцию Оп)гаш», как показано ниже, чтобы она выводила сообщение: 


у01а СЕх11а\1ем: :ОпОгам(СОС» роб) 

{ 
СЕх11а0ос» рбос = бефбоситеп{(): 
АЗЗЕВТ_УАЕТО(р0ос): 


роС->ТехЕ0и{(0, 0, “Ргезз {пе 1еРЕ тоизе Бифоп Неге."); 


Создайте функцию Ой[Вийопроити для обработки сообщения ИМ _ГВИТ- 
ТОМРО\М. Выберите класс СЕх11аеи в С!а$$ Утеу, в окне Ргорегие$ щелкни- 
те кнопку Ме5зазе$, выберите сообщение УМ [ВИТТОМРО\\, создайте функ- 
цию От Вийопроит и добавьте в нее выделенный КОД: 


\019 Сех11а\ тем: : ОпЕВиопбомп (ИТМТ пЕ1адз, СРо1п+ ро1п{) 
{ 

ССотрите019 919; 

919. 0оМода1(); 


С\1ем: : ОпЕВи{фопбомп(пЕ1ад$, ро1п+): 


Этот код открывает модальное диалоговое окно всякий раз, когда пользова- 
тель нажимает левую кнопку мыши, а курсор находится в окне представления. 
Пока у вас еще открыт файл Ех11а\1еуусрр, введите оператор: 


#1пс1и49е “Сотрифе019. в” 


Соберите и запустите приложение. Поместив курсор в окно представле- 
ния, щелкните левой кнопкой, чтобы активизировать диалоговое окно. Щелк- 
ните кнопку З{агь, затем — Сапсе!. Индикатор продвижения должен показывать 
состояние процесса вычислений. 


Обработка в периоды простоя 


До многопоточности разработчики программ для У/п4о\з использовали перио- 
ды простоя (1е ите) для выполнения фоновых задач, например, разбивки доку- 
мента на страницы. Теперь обработка во время простоя потеряла былое значение, 
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но ей по-прежнему находится применение. Каркас приложений вызывает вирту- 
альную функцию-член От 4 класса Старр, и вы можете переопределить ее для 
выполнения фоновых вычислений. Оп1е вызывается из цикла обработки сооб- 
щений МЕС-библиотеки, который на самом деле сложнее, чем приведенная выше 
простая последовательность СеМеззаве/ГгапяющеМе$з аве/ОбрейсЬМеззаюе. 

Обычно по завершении своей работы функция От 4 не вызывается до следу- 
ющего опустошения очереди сообщений. Если вы переопределяете ее, вызывает- 
ся ваш код, но при отсутствии непрерывного потока сообщений эта функция не 
вызывается. Ой/ще в базовом классе обновляет кнопки панели инструментов и 
индикаторы состояния, а также «подчищает» указатели на временные объекты. 
Имеет смысл переопределять эту функцию для обновления состояния элементов 
пользовательского интерфейса. Ну, а то, что никакого кода не выполняется в от- 
сутствие сообщений, не важно: пользовательский интерфейс и не должен в этом 
случае изменяться. 


Примечание Переопределяя функцию СтАрр::От@, не забудьте вызвать 
От базового класса. Иначе не произойдет ни обновления кнопок на 
панели инструментов, ни удаления временных объектов. 


От вообще не вызывается, если пользователь работает в модальном диало- 
говом окне или выбирает что-то в меню. При необходимости фоновой обработ- 
ки модальных диалоговых окон или меню придется написать обработчик сооб- 
щения УМ _ЕМТЕЮИХЕ, но его надо добавить в класс окна-рамки, а не в класс «вид». 
Причина в том, что владельцем диалоговых окон всегда является основное окно- 
рамка приложения, а не окно представления. О взаимосвязи окна-рамки и окна 
представления см. главу 14. 


Программирование многопоточных приложений 


Как вы помните из главы 10, ироцесс (ргосез5) — это выполняемая программа, 
обладающая собственной памятью, описателями файлов и другими системными 
ресурсами. Процесс может содержать несколько параллельно исполняемых отрез- 
ков кода — потоков (Шгеаа). Но не ищите отдельного кода для разных потоков, 
потому что одну функцию могут вызывать несколько потоков. По большей части 
все пространство кода и данных процесса доступно всем его потокам. Два пото- 
ка могут, например, обращаться к одним глобальным переменным. Потоками уп- 
равляет ОС, и у каждого потока есть свой стек. 

В \шао\ есть потоки пользовательского интерфейса (изег-ице!Ёасе Шгеаа) 
и рабочие (\огкег Шгеаа). МЕС-библиотека поддерживает оба вида. У потока 
пользовательского интерфейса есть окна, а значит, и свой цикл выборки сообще- 
ний, ау рабочего — нет.! Рабочие потоки легче программировать, и они обычно 
полезнее. Примеры в этой главе иллюстрируют рабочие потоки. Но в конце гла- 
вы описывается приложение с применением потока пользовательского интерфейса. 


' Такое деление весьма условно, так как у рабочего потока, если нужно, может быть 
цикл выборки сообщений. — Прим. перев. 


226 Часть И Основы МЕС 


Не забывайте, что даже в однопоточном приложении есть поток, называемый 
основным (тат 1геаа). В иерархии МЕС-классов СУтАрр является производным 
от СИтТЬгеаа. В главе 2 было сказано, что иШтяапсе и т рМат\па — это эле- 
менты класса Старр. Вообще-то это неправда. Эти элементы объявлены в С\Ит- 
Тртеаа, но, конечно же, наследуются классом СУтАРР. Здесь важнее помнить, что 
приложение — это и есть поток. 


Написание функции рабочего потока и запуск потока 


Если вы еще не догадались сами, то знайте: для выполнения длительных вычис- 
лений рабочий поток эффективнее обработчика сообщений, содержащего вызов 
РееЕМеззаве. Однако прежде чем думать о запуске рабочего потока, надо написать 
для него глобальную функцию. Она должна возвращать значение типа ШУТ и 
принимать в качестве параметра одно 32-разрядное значение, объявленное как 
ТРУОШ. При запуске потока через этот параметр можно передать ему все, что угод- 
но. Поток выполняет свои вычисления и завершается, когда глобальная функция 
возвращает управление. Он завершается и при закрытии процесса, но лучше, чтобы 
рабочий поток завершался раньше — это поможет предотвратить утечку памяти. 

Чтобы запустить поток (с функцией, скажем, СотршеТЬгеааРгос), программа 
делает вызов: 


Си1пТпгеад* рТИгеаа = АРхВед1пТвгеаа (СотритеТпгеачРгос, бетЗафеНмпа(), 
ТНАЕАО_РАТОВТТУ_МОВМАЕ): 


Код функции потока выглядит примерно так: 


ОТМТ СотрифеТигеааРгос (1РУОТО рРагапт) 
{ 

// процесс. обработки 

гефигп 0; 


Функция АхВевтТргеаа возвращает управление сразу; она возвращает указа- 
тель на только что созданный объект «поток». Этот указатель позволяет приоста- 
новить и возобновить исполнение потока (СтТртеаа::5изрепаТьтеа4 и Кезите- 
Тргеаа), но у объекта «поток» нет функции-члена для уничтожения потока. Вто- 
рой параметр функции АйВезтТьтгеаа — 32-разрядное значение, передаваемое гло- 
бальной функции, а третий представляет собой код приоритета потока. После 
запуска рабочего потока оба потока исполняются независимо друг от друга. \Ат- 
Чоу’ распределяет время между ними (и потоками других процессов) согласно 
их приоритетам. Пока основной поток ожидает сообщение, ОС продолжает ис- 
полнение потока вычислений. 


Общение основного потока с рабочим 


Существует много способов связи между основным и рабочим потоками. Однако 
УЛпаоу’-сообщение отправляться точно не будет — у рабочего потока нет цикла 
выборки сообщений. Простейшее средство коммуникации — глобальная перемен- 
ная, поскольку все глобальные переменные доступны всем потокам процесса. 
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Допустим, рабочий поток в процессе вычислений увеличивает и проверяет 
значение глобальной целочисленной переменной, завершаясь, когда значение 
переменной достигает 100. Основной поток может принудительно завершить 
рабочий поток, присвоив глобальной переменной значение 100 или более. Сле- 
дующий код, на первый взгляд, должен работать, и, если вы его протестируете, 
может, так и случится: 


ОТМТ СотритеТпгеааРгос(1ЕРУОТО рРагам) 
{ 
9_пСоипт = 0; 
мп11е (9_пСоипт++ < 100) { 
// здесь выполняются какие-то вычисления 


} 


гетигп 0; 


Однако здесь есть одно «но», которое можно обнаружить, лишь посмотрев на 
сгенерированный ассемблерный код. Значение © пСоип{ загружается в регистр, 
увеличивается в нем же и переписывается обратно ва пСоит. Пусть в пСоипё равно 
40, и УЛпао\$ прерывает рабочий поток сразу же после того, как он загружает 
это значение в регистр. Теперь управление получает основной поток и присваи- 
вает а пСои значение 100. При возобновлении рабочий поток увеличивает зна- 
чение регистра и записывает обратно в а пяСои число 41, стирая предыдущее зна- 
чение 100. Результат — цикл потока не завершается! 

Если же мы включим оптимизацию кода при компиляции, то получим допол- 
нительную проблему. Переменную &_пСоип! компилятор размещает в регистре, 
причем значение переменной остается загруженным в него на протяжении всего 
цикла. Если основной поток изменит значение &_иСоити в памяти, это не повли- 
яет на цикл вычислений в рабочем потоке. (Однако, чтобы компилятор не хра- 
нил счетчик в регистре, можно объявить 8 пСоитЁ как ое.) 

Но допустим, вы переписали процедуру потока: 


ИТМТ СотрифеТпгеаадРгос(ЕРМОТО рРагам) 
{ 
9_пСоипт = 0; 
мп11е (9_пСоипЕ < 100) { 
// здесь выполняются какие-то вычисления 
; : [пфег]оскедТпсгемепт ( (1опд*) &9_пСоип{); 
} 


гетигп 0; 


Функция пиепоскетстетет предотвращает обращение к переменной со сто- 
роны другого потока во время ее изменения. Теперь основной поток сможет за- 
вершить рабочий. 

Итак, вы познакомились с некоторыми подводными камнями, подстерегающими 
программиста при использовании глобальных переменных. Иногда применение 
глобальных переменных оправданно, что иллюстрирует следующий пример, но 
есть и альтернативные методы, более гибкие; и мы еще обсудим их в этой главе. 
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Общение рабочего потока с основным 


Вполне разумно использовать глобальную переменную, значение которой пери- 
одически проверяет рабочий поток, но что, если то же самое сделает основной 
поток? Помните «жадную» функцию? Безусловно, нежелательно, чтобы основной 
поток входил в цикл — ведь это лишь потеря процессорного времени, да и ваша 
программа перестанет обрабатывать сообщения. Для связи рабочего потока с ос- 
новным лучше передавать сообщения УЛп4о\, так как у основного потока уже 
есть цикл выборки сообщений. Однако это подразумевает, что у основного пото- 
ка есть окно (видимое или нет), а у рабочего потока — его описатель. 

А как рабочий поток получит описатель? Для этого служит 32-разрядный па- 
раметр уже рассмотренной функции потока. Вы просто передаете описатель в 
вызове А/хВезтТртеаа. Но почему бы вместо него не передать указатель на объект 
«окно» С++? Это может оказаться опасным, так как нельзя полагаться на то, что 
этот объект будет существовать постоянно, и, кроме того, разным потокам не 
разрешается совместно использовать объекты МЕС-классов. (Это правило не рас- 
пространяется на объекты классов, производных непосредственно от СОБесь и 
на объекты таких простых классов, как СКес! или С5йтв.) 

Как посылать сообщение: синхронно (5еп9) или асинхронно (роз? Асинхрон- 
ная передача предпочтительнее, так как синхронная может вызвать повторное 
вхождение в МЕС-код для выборки сообщений основного потока, а это чревато 
проблемами. А какое сообщение следует посылать? Да любое пользовательское. 


Пример Ех11Ь 


Внешне Ех11Ь выглядит абсолютно так же, как программа Ех11а. Однако, обра- 
тившись к ее коду, вы заметите различия. Вычисления выполняются в рабочем, а 
не в основном потоке. Значение счетчика хранится в глобальной переменной 
& пСоит, которой присваивается максимальное значение в обработчике кнопки 
Сапсе! диалогового окна. Завершаясь, поток посылает сообщение диалоговому окну, 
что вызывает завершение функции РоМоаа/. 

Классы документа, представления, рамки и приложения остались теми же за ис- 
ключением имен; не изменился и диалоговый ресурс. Класс модального диалого- 
вого окна по-прежнему называется ССотрше[ 1, но его реализация изменилась. 
Конструктор, обработчик таймера и функции обмена данными практически те же. 

Следующий код показывает определение глобальной переменной и глобаль- 
ную функцию потока из файла \Ех1 16\Сотрше[!®.срр с компакт-диска. Заметь- 
те: возврат из функции (и завершение потока) происходит, когда в_пиСоии! пре- 
вышает определенное максимальное значение. Однако, прежде чем завершиться, 
функция асинхронно отправляет диалоговому окну пользовательское сообщение: 


11 9_пбоипт = 0; 
ОТМТ СотрифеТпгеааРгос (1РУОТО рРагат) 
{ 


\01а{11е 1п{ пТетр; // уо1ат11е, иначе компилятор перестарается с оптимизацией 


Рог (9_пСоипе = 0; д9_пСоипе < Сботрифер19: : пМахбоип*; 
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: Шофег1оскедТпсгетепт((10п9*) &9_пСоцпт)) { 
Тог (пТетр = 0: пТетр < 50000; пТетр++) { 
// просто занимаем процессор 

} 
} 
// \М_ТНВЕАОЕТМТ$НЕОВ = это пользовательское сообщение 
: : Роз1Меззаде ( (НИМО) рРагатм, \М_ТНВЕАБВЕТМТЗНЕО, 0, 0); 
9_пСоип = 0; 
гетигп 0; // завершаем поток 


Показанный ниже обработчик ОиВпСйсвея ит связан с кнопкой ${ап диало- 
гового окна. Его задача — запустить таймер и рабочий поток. Третий параметр 
АрхВевтТьЬтеаа позволяет изменять приоритет рабочего потока — например, вы- 
числения замедляются, если установить самый низкий приоритет (ТНКЕАР_ РЮЮО- 
МТУ 1ОМЕ$Т): 


\014 ССотрите019: : ОпВпС11скеа$тагт(.) 
{ 
п_пТ1мег = $е+Т1мег(1, 100, МИГ); // 1/10 секунды 
АЗЗЕВТ( м_пТ1мтег |= 0); 
бет019Ттем(ТОС_5ТАВТ)->Епаб1е\1пдом( РАЕЗЕ); 
АГхВед1пТпгеаа( СотритеТпгеаЧ9Ргос, бетЗаРеНмпа(), 
ТНАЕАО_РАТОВТТУ_МОВМАЕ); 


Обработчик ОпВиСйскеяСапсе! (см. ниже) связан с кнопкой Сапсе! диалогово- 
го окна. Он присваивает переменной в иСоит максимальное значение, что при- 
водит к завершению рабочего потока: 


\014 ССотрите019: : ОпВпС11ске9Сапсе1() 
{ 
11 (9_пСоипе == 0) { // до нажатия кнопки Зфаг* 
С01а109: : ОпСапсе1(); 
} 
е1зе { // идут вычисления 


9_пСоипф = пМахСоип{; // принудительное завершение потока 
} 


Обработчик ОпТртеааЁЕ ирей сопоставляется отправляемому в диалоговое окно 
пользовательскому сообщению УМ _ТНКЕАРЕШМ!$НЕРО. Он заставляет функцию 
РроМоа завершить свою работу: 


ЕВЕЗИЕТ ССотрифе019: :ОпТпгеа9Е1п1зНед(МРАВАМ мРагат, ГРАВАМ 1Рагат) 
{ 
бе{0191{ет(ТОС_ЗТААТ)->Епаб1ем1паом( ТВУЕ); 


(01а109: :ОпОК(); 
гетигп 0; 


9—2064 
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Синхронизация потоков с использованием событий 


Применение глобальной переменной — грубое, но эффективное средство связи 
потоков. Попробуем что-нибудь более совершенное и попытаемся мыслить в тер- 
минах синхронизации потоков, а не простой передачи информации. Наши пото- 
ки должны тщательно синхронизировать свое взаимодействие. 

Событие (еуеп0) — один из типов объектов ядра (процессы и потоки тоже 
относятся к объектам ядра), предоставляемых \/Л1п90%$ для синхронизации по- 
токов. В пределах конкретного процесса событие определяется уникальным 32- 
разрядным описателем и для совместного использования несколькими процес- 
сами может идентифицироваться по имени (или описатель события может дуб- 
лироваться в другом процессе). Объект «событие» находится либо в свободном 
(ТВОЕ, явпа!е4 этазе), либо в занятом (ЕАТЗЕ, ипу1епаеа з1а{е) состоянии. Собы- 
тия бывают с ручным (тапиа! гезе0) и автоматическим сбросом (ацтогезег). Мы 
рассмотрим события последние, так как они идеально подходят для синхрониза- 
ции двух процессов. 

Вернемся к примеру с рабочим потоком. Мы хотим, чтобы основной поток 
(поток пользовательского интерфейса) сигнализировал рабочему потоку, когда 
начинать и прекращать работу. Поэтому нам понадобятся события «запустить» 
(зсаго) и хуничтожить» (КШ). МЕС предоставляет для этого удобный класс СЕоепь 
производный от СбупсОБес. Конструктор по умолчанию создает объект Х/1п52 
«событие» с автосбросом в занятом состоянии. Если определить события как гло- 
бальные объекты, любой поток сможет легко обратиться к ним. Когда основному 
потоку надо запустить или уничтожить рабочий поток, он переводит соответству- 
ющее событие в свободное состояние вызовом СЕфепё:5еЕиети. 

Теперь рабочий поток должен наблюдать за состоянием двух событий и долж- 
ным образом реагировать, когда одно из них переходит в свободное состояние. 
Для этого в МЕС есть класс СУтфеГосЕ, но проще вызвать У\Лп32-функцию ШайЕРот- 
5тяеОвБес. Она приостанавливает поток, пока заданный объект не освободится. 
В приостановленном состоянии поток не занимает процессорного времени, и это 
хорошо. Первый параметр функции ШайЕРотутяеОвтес! — описатель события. 
В качестве значения этого параметра можно использовать сам объект СЕиепё, по- 
тому что он наследует от класса СбупсОБес оператор НАМОГЕ, который возвра- 
щает описатель события, хранящийся в открытой переменной-члене. Второй па- 
раметр определяет период тайм-аута. Если его значение /ИМЕМТЕ, освобождения 
объекта «событие» функция ожидает неопределенно долго (вечно), а когда оно 
равно 0, функция сразу возвращает управление с резульгатом МАГГ ОВ/ЕСТ 0, если 
событие было в свободном состоянии. 


Пример Ех11с 


В этой программе для синхронизации рабочего и основного потоков использу- 
ются два события. Большая часть кода Ех11с взята из примера Ех11Ь, но класс 
ССотршер® реализован иначе. Файл 5ААЁх.В содержит строку, необходимую для 
класса СЕфепё 


Нис1иде <аРхтт. п> 
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В программе два глобальных объекта-события, как показано ниже. Заметь- 
те: конструкторы создают события УЛп4о%$ до начала исполнения главной про- 
цедуры: 


СЕ\меп{ д_еуепЕ5{агт; // создает события с автосбросом 
СЕуепЕ 9_еуеп{К111 


Сначала лучше всего изучить глобальную функцию рабочего потока. Как и в 
Ех11Ъ, она увеличивает значение счетчика © пСоит. Рабочий поток запускает 
функция ОпйтйП ов, а не обработчик сообщений от кнопки 51а. При первом 
вызове функция УяйЕотутЯеОВес! ждет события «запустить», которое переводится 
в свободное состояние обработчиком кнопки $1аг. Параметр ИУЕМТЕ означает, 
что поток будет ждать столько, сколько надо. Второй вызов УяйЕогутеОБест 
отличается от первого — здесь задержка нулевая. Этот вызов расположен в основ- 
ном цикле вычислений и просто проверяет, не освобождено ли событие «КШь 
обработчиком кнопки Сапсе!. Если это так, поток завершается. 


ОТМТ СотрифеТнгеааРгос ( (РУОТО  рРагат) 
{ 
\0]а{11е 111 пТетр; 


: М№а11Рог51191е06]ес*(9_еуепЕ5фагЕ, ТМЕТМТТЕ); 
ТВАСЕ("зтаг{1п9 сотрита{1оп\п”); 
Тог (9_пСоип{ = 0; 9_пСоипт < ССотрите019: : пМахСоип*; 
9_пСоцпт++) { 
Тог (пТетр = 0; пТетр < 10000; пТетр++) { 
// имитируем вычисления 
} 
ТЕ (:;Ма{Рог51191е06ес*(9_еуеп{К111, 0) == МАТТ_ОВУЕСТ_0) { 
ргеак 
} 
} 
// Сообщить окну-владельцу об окончании работы 
: :Ро${Меззаде( (НИМО) рРагам, ММ_ТНАЕАОЕТМТЗНЕО, 0, 0) 
9_пСоип{ = 0; 
гефигп 0; // завершаем поток 


А вот функция От/тйП ов, вызываемая при инициализации диалогового окна 
(заметьте: она запускает рабочий поток, который бездействует, пока не освобо- 
дится событие «запустить»): 


ВОО ССотрите019: :Оп1п1{01а109() 
{ 
(01а109: :0п111101а109(); 
АРхВед1пТнгеад ( СотрифеТпгеааРгос, бетЗаРеНмпа()); 
гефигп ТВИУЕ; // возвращать ТВОЕ, если не установлен фокус на элементе управления 
// ИСКЛЮЧЕНИЕ: Страницы свойств 0СХ должны возвращать РАЕЗЕ 


Далее обработчик кнопки 51а! устанавливает событие «запустить» в свободное 
состояние и тем самым запускает цикл вычислений рабочего потока: 
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\019 ССотритер19 : :ОпВиС11скеад$ таг () 

{ 
м_пТ1мег = 5еТ1тег(1, 100, №11); // 1/10 секунды 
АЗЗЕВТ(т_пТ1тег != 0); 
бе+019Т+ет(ТОС_5ТАВТ)->Епаб1е\1пдом( РАЕЗЕ); 
9_еуепЕ5 таг. Зе=Еуепт(); 

} 


Обработчик кнопки Сапсе! устанавливает событие «уничтожить» в свободное со- 
стояние, что вызывает завершение цикла вычислений рабочего потока: 


\019 ССотри{е019: : ОпВпС11скедСапсе1 () 
{ 
1Е (9 пСоипф == 0) { // до нажатия кнопки З+%аг* 
// До уничтожения потока его надо запустить 
9_еуепЕ5Таг+. зетЕуепт{(); 
} 
9_е\уеп{К111. ЗетЕуепт(); 


Обратите внимание на весьма неуклюжее применение события «запустить», 
когда пользователь отменяет окно, не запустив процесса вычислений. Аккуратнее 
было бы определить новое событие «отменить» и заменить в функции Сотрше- 
ТртеааРгос первый вызов УайЕотутаеОБес на вызов УяйЕОоТМширеОБеси. Если 
бы УяйЕо’Мишр/еОБес!5 обнаруживала событие «отменить», это могло бы приво- 
дить к немедленному завершению потока. 


Блокировка потоков 


Пример блокировки потока — первый вызов ИяйЕоттяеОБес в функции Сотри- 
ТртеааРтос. Поток просто прекращает выполнение до освобождения события. 
Способов заблокировать поток много. Можно, например, вызвать \/1152-функцию 
$1еер, чтобы «усыпить» поток на 500 мс. Блокировку потока вызывают и функции, 
которые обращаются к устройствам вроде коммуникационных портов или дис- 
ков. Во времена 16 эти функции захватывали процессор до завершения сво- 
ей работы, а в \/132 они позволяют выполняться другим процессам и потокам. 

Избегайте блокирующих вызовов в основном потоке пользовательского интер- 
фейса. Если заблокировать основной поток, он не сможет обрабатывать сообще- 
ния, и работа программы покажется замедленной. Если у вас есть задача, требую- 
щая интенсивных операций дискового ввода/вывода, поместите соответствующий 
код в рабочий поток и синхронизируйте его с основным потоком. 

Будьге осторожны с вызовами, способными заблокировать рабочий поток на 
неограниченное время. Сверьтесь с документацией, можно ли для данной кон- 
кретной операции ввода/вывода установить интервал задержки. Вызов может бло- 
кировать поток навсегда, однако последний все равно завершится при заверше- 
нии основного потока процесса, но тогда не исключены утечки памяти. Можно 
также вызвать из основного потока функцию \1п32 7ТегттитешеТртеаа, но и тогда 
проблемы утечки памяти не избежать. 
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Критические секции 


Помните сложности с доступом к глобальной переменной в иСоипй Если требу- 
ется организовать совместный доступ нескольких потоков к глобальным данным 
и для этого вам нужна большая гибкость, чем та, что предоставляют простые опе- 
раторы типа И#епоскейтстетети, лучше всего подойдут критические секции (сйаса! 
зесцоп$5). События хороши для «сигнализации», а критические секции (секции кода, 
требующие монопольного доступа к совместно используемым данным) — для уп- 
равления доступом к данным. 

МЕС предоставляет класс ССийса5есйоп — «обертку» описателя критической 
секции УЛпао\у5. Его конструктор вызывает функцию ищайзеСсиисабесиоп, фун- 
кции-члены /осё и Отосе вызывают функции ЕщетСтйсе5есноп и ГеаоеСийса!- 
5есиоп соответственно, а деструктор вызывает ДевеСписей5есноп. Вот как можно 
использовать этот класс для защиты глобальных данных: 


(ССг141са15ес{10оп 9_с$; // Глобальные переменные, доступные из всех потоков 
11 9_пСоипт; 
№\019 Типс() 
{ 
9_с$. 1оск(): 
9_пСоипт++; 
9_с$.Ип1оск(); 


Допустим, ваша программа отслеживает показания времени как часы, минуты 
и секунды, а каждое из этих значений хранится в отдельной целочисленной пе- 
ременной. Теперь представим, что значения времени совместно используются двумя 
потоками. ПотокА изменяет значение времени и прерывается потоком В после 
обновления часов, но до обновления минут и секунд. Результат: поток В получает 
недостоверные показания времени. 

Если вы создаете для данного формата времени класс С++, то сможете легко 
управлять доступом к данным, сделав элементы данных закрытыми и предусмот- 
рев открытые функции-члены. Таков показанный в следующем примере класс СНМб. 
Заметьге: в нем есть переменная-член типа ССийсабесноп. Так что с каждым объек- 
том СНМ$ связан объект «критическая секция». 

Заметьте: другие функции-члены вызывают функции-члены Госё и Итосе. Если 
потокА исполняется в середине 5е! Гйте, поток В будет блокирован вызовом Ещет- 
Стшсабесиоп в сео ес$ до того, как поток А не вызовет ГеазеСтисаесноп. 
Функция /истетет ес; вызывает 5е{Типе, что означает наличие вложенных кри- 
тических секций. Это допустимо, так как \Лп4о\/5 отслеживает уровни их вложен- 
ности. 

Класс СНМ$ отлично работает, если вы применяете его для конструирования 
глобальных объектов. Если же потоки вашей программы совместно используют 
указатели на объекты в куче, вы столкнетесь с рядом других проблем. Каждый поток 
должен определять, не удален ли объект другим потоком, а значит, нужна синх- 
ронизация доступа к указателям. 
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Мы не приводим пример программы, использующей класс СНМ5, но на ком- 
пакт-диске в подкаталоге Ех11с есть файл НМ$.В. Создавая многопоточную про- 
грамму, вы сможете применять этот класс для совместного использования глобаль- 


ных объектов между потоками. При этом вам не понадобятся другие функции, 
связанные с синхронизацией потоков. 


Мьютексы и семафоры 


Как мы уже говорили, подробные сведения об объектах синхронизации вы най- 
дете в книге Джеффри Рихтера. Мьютекс (тщех — сокращение от тиа! ехсш- 
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$юп — взаимное исключение) или семафор могут потребоваться, если нужно уп- 
равлять доступом к данным, совместно используемым разными процессами, так 
как критическая секция доступна лишь в пределах одного процесса. Мьютексы и 
семафоры совместно используются процессами и идентифицируются по именам‘. 


Потоки пользовательского интерфейса 


МЕС-библиотека обеспечивает хорошую поддержку потоков пользовательского 
интерфейса. Вы создаете класс, производный от СЁтТртеаа, и вызываете пере- 
определенную версию АрхВеотТЬтеаа для запуска потока. У этого производного 
класса есть своя функция ишияапсе и, что самое важное, свой цикл выборки 
сообщений — это позволяет конструировать связанные с ним окна и обработчи- 
ки сообщений. 

Зачем нужен поток пользовательского интерфейса? Если вы хотите работать 
с несколькими окнами верхнего уровня, их можно создать и управлять ими из 
основного потока. Но допустим, вы разрешаете пользователю запускать несколь- 
ко экземпляров вашего приложения и хотите, чтобы все они совместно обраща- 
лись к общей памяти. Можно сделать так, чтобы в одном процессе исполнялось 
несколько потоков пользовательского интерфейса, а пользователи думали, что 
выполняются отдельные процессы. Именно так работает УЛпаоу$ Ехр!огег. Запу- 
стите утилиту 5РУХХ и убедитесь сами. 

При запуске второго и последующих потоков без уловок не обойтись, так как 
пользователь фактически каждый раз запускает новый процесс. При запуске вто- 
рого процесса тот сигнализирует первому запустить второй поток и завершает- 
ся. Второй процесс обнаруживает первый либо с помощью \/п32-функции Ета- 
Утаош, либо путем объявления общей секции данных. Общие секции данных 
детально рассматриваются в книге Джеффри Рихтера. 


' А также путем дублирования описателей аналогично событиям. — Прим. перев. 
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Классы основного окна-рамки и документа 


До сих пор мы использовали окно представления так, словно это единственное 
окно приложения. Но в $01-приложении (Зазе Роситеп( Име!асе) это окно 
располагается внутри другого окна — основного окна-рамки приложения. Имен- 
но ему принадлежат заголовок и меню. Клиентскую область основного окна за- 
нимают всевозможные дочерние окна, в том числе окно представления, окно 
панели инструментов и окно строки состояния (рис. 12-1). Каркас приложений 
управляет взаимодействием между окном-рамкой и окном представления, доставляя 
сообщения от первого второму. 


Дочерние Окно представления — 

окна _ . __ 
Основное 
окно-рамка 
$01-приложения 


Рис. 12-1. Дочерние окна в основном окне-рамке 5/-приложения 


Посмотрите еще раз на файлы какого-нибудь проекта, которые мы сгенери- 
ровали, используя МЕС АррИсайоп У/2ага. Файлы МашЕгт.В и МатЕпт.срр содержат 
код класса основного окна-рамки приложения, производного от класса СЕтате\иа. 
В других файлах (например, Ех12аРос.В и Ех12аРос.срр) хранится код класса 
документа, производного от СРоситети. С этой главы мы будем работать с МЕС- 
классом «документ». Начнем с того, что каждый объект «вид» связан только с од- 
ним объектом «документ» и функция-член Сеоситеп! возвращает указатель на 
этот документ. В главе 15 мы продолжим изучение взаимодействия «документ-вид>. 


Меню \М/тдом$ 


Меню М!сгозой УЛпо\$ — знакомый всем компонент приложения, состоящий из 
горизонтального списка элементов верхнего уровня; с ним связаны меню, откры- 
вающиеся при выборе пользователем какого-либо из его элементов. Обычно для 
окна-рамки определяется ресурс меню по умолчанию, загружаемый при создании 
этого окна. Можно определить и ресурс меню, не связанный с каким-либо окном- 
рамкой. В этом случае ваша программа должна вызывать функции, необходимые 
для загрузки и активизации меню. 
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зательно должна соответствовать какой-либо команде в меню. Даже если в меню 
ЕАК нет команды Сору, ничто не мешает вам назначить комбинацию клавиш СИ1+С 
для инициирования команды /[2_ЕШМТ _СОРУ. 


Примечание Если быстрая клавиша связана с командой меню или кнопкой 
панели инструментов, то при отключении команды или кнопки отклю- 
чается и эта клавиша. 


Обработка команд 


Как вы уже видели в главе 2, в каркасе приложений есть весьма изощренная сис- 
тема маршрутизации командных сообщений, поступающих при выборе элемен- 
тов меню, нажатии быстрых клавиш, а также при щелчке кнопок на панелях ин- 
струментов или в диалоговых окнах. Командные сообщения можно также отправ- 
лять, вызвав функцию С\Уиа::5епАМеззаве или Ро Ме5засе. Сообщения идентифи- 
цируют #4ейпе-константы, часто назначаемые в редакторе ресурсов. У каркаса 
приложений собственный набор идентификаторов внутренних командных сооб- 
щений, например, /2_ЕЦЕ РАМТ или Ш_ЕШЕ ОРЕМ. А файл Везочгсе.В вашего 
проекта содержит уникальные идентификаторы конкретного приложения. 

Большинство командных сообщений генерируется в окне-рамке приложения, 
и именно здесь, не будь каркаса приложений, вам пришлось бы размещать обра- 
ботчики команд. Система же маршрутизации команд позволяет обрабатывать эти 
сообщения практически где угодно. Обнаружив командное сообщение от окна- 
рамки, каркас приложений начинает поиск соответствующих обработчиков в таком 
порядке. 


В $01!-приложении В МО!-приложении 

Класс «вид» Класс «вид» 

Класс «документ» Класс «документ» 

Класс основного окна-рамки $01 Класс дочернего окна-рамки МОТ 
Класс «приложение» Класс основного окна-рамки МПТ 


В большинстве приложений обработчик конкретной команды присутствует в 
одном классе, но если в программе с одним окном представления два обработчи- 
ка — и в классе «вид», и в классе «документ», то, поскольку окно представления в 
иерархии распределения команд занимает более высокую ступень, вызывается 
обработчик класса «вид». 

Как создать функцию-обработчик команды? Требования к определению тако- 
го обработчика аналогичны уже известным вам правилам определения обработ- 
чика оконных сообщений. Для этого нужна сама функция, соответствующий эле- 
мент в карте сообщений и прототип функции. Допустим, в меню есть команда Гоот 
(с идентификатором М _2ООМ), которую надо обрабатывать в классе «вид». В этом 
случае добавьте сначала в файл реализации класса «вид» такой код: 


ВЕСТМ_МЕЗЗАСЕ_МАР(СМУ\1ем, С\1ем) 
0№_СОММАМО(ТОМ_700М, 0Оп2оот) 
ЕМО_МЕЗЗАСЕ_МАР() 
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ЕМО_МЕЗЗАСЕ_МАР() 


\0149 СМу\1ем: :ОпИрдате?оот(ССта/Т» рСтаит) 
{ 


рстаут->5еСпеск(т_57о00тед); // м_6200тед - переменная-член класса 


Прототип следует включить в заголовочный файл класса (перед макросом 
ДЕСГАКЕ МЕЗЗАСЕ_МАР): 


аРх_тз9 у01а ОпИрдате7оот(ССтауТ» рСмаит); 


Понятно, что мастера С1а5$ Меуу автоматизируют и процесс вставки обработ- 
чиков, обновляющих командный пользовательский интерфейс. 


Команды, генерируемые диалоговыми окнами 


Допустим, вы хотите, чтобы одна из кнопок диалогового окна посылала команд- 
ное сообщение. Идентификаторы команд должны попадать в диапазон 0х8000— 
ОХОЕЕЕ который редактор ресурсов использует для элементов меню. Если при- 
своить кнопке диалогового окна идентификатор из этого диапазона, она будет 
генерировать команду, маршрутизируемую каркасом приложений. Сначала кар- 
кас пересылает эту команду основному окну-рамке, так как именно оно — владе- 
лец всех диалоговых окон. Затем доставка команды пойдет обычным путем; если 
в классе «вид» есть обработчик командного сообщения от кнопки, он и будет ее 
обрабатывать. Чтобы значение идентификатора не вышло за указанный выше 
диапазон, используйте диалоговое окно Везоигсе 5утро!$ в редакторе ресурсов, 
позволяющее определить идентификатор до назначения его кнопке. 


Встроенные меню каркаса приложений 


Создавать меню для каждого окна-рамки с нуля нет нужды — в библиотеке МЕС 
уже определено несколько полезных меню (рис. 12-3) со всеми функциями-об- 
работчиками команд. 


ен1!2а - уптыНед 


Рис. 12-3. Стандартные меню в окне-рамке 5О/-приложения 
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9овиЯ-ОЗИ гогечиьэ2990 члоохоил Але ‘виноияетопо4и енхо хех ‘инэивииая ино 9 
Оль ‘ел и чаеиопо онжом он ‘хенхо хччолонеий я виноияеЧ нА лалномоне хех члея 
-ОЯлОиЭИЕЕ онжои хи `(юзио2 чоцииоо зтрэ чом) изинвяоЧилеиоф о впояя экон и 
(021905 рэ) вгояя эиоц эонычоо :елояол, кинеяоЧиляреИэ4 ватэпэдо ваи $моригх Я 


Э-Ш а е19эхэ1 эинезоди1хе!эч 


'иинэш9о0 ханинеиохл хите илиьлоое9о чнэоиэпэ4но эн «аинэиАзо ики 
«Пия» эоэвих ионшояБиоЧи я ипоэ ‘вологевоияло ино ‘аотнаиэце поовя4ех хаиэвя 
-Е1ЕОО ‘91584 и 4409 919 ‘Тря огни ханлАейнело иинэшонло а ондэя эж ое ‘вин 
-эиатлоио4и онхо эоя4ои оняиляе вито очиол ‘еняиляе тэиАо ихие4-енхо отнои а 
41007 еИнвиоя эвьАио иоте Я 'ИОО7 Иагияинеиоя хиьзодед90 волрэии «Гия» эоэвия 
иоя4ри я оланол, он ‘елноиАхой олонпо винэияелото4и вяй алоэ эвя А ‘иилоАНОЙ 
ридаши 
-ВНо воэвих аавияпиайотуч ш 1 ионнэиэ4эн явтуя эинэьен$ яиояри4и ‘атилэ4а 
Пе ОНЖОИ ЭИНЭШЭЯО ЭОНООПОй 7] АМУИИЮЭ Ааа МО ихиьлоое4оо члеоин 
илромишохооэн 10 товиявови оле и чаинвиох элА4шАви иэшАлэа, ен хиьлоое4оо 
ичнжАн вИиен эн ‘отнои Аинеиох чливополо иво нэооэоно иинэжогиаи овя4еЯ 


наи а Унеиох эинэноих10 и эинэвоиуЯ 


(мэтлезазитачетт-и0::метлэ ‘МАтлЭча 1194 э7т-`ат)аммиио9`№ 
(Зит4этт440::метлэ ‘1мтНа Э7т- от) аммино9 № 


‘пало 
чэн в ‘92аААИГО эоЭвия я ланэнэпэ4но эжин ханнэпэчи4и эпо4я 1алноиэие Аиэьон 
108 "еовия олонпоявио4н олонаэ4яном ки! колоАдиаэнол в чанэиэиэ4по эн иалЭ 
Эви я ИИНоШ900Э элея я чанзирие эишоя11291002 ‘енанолеевооэн илеьэн 
вяжАэи!ои явя мет, ‘мэтлэла лава и зама онэи золнэиэие лэША9 эн ‘мэмэла зара 
риу Зипина хожеиф члиродоо иизэ ‘мет, 'рлегих ионтона4у Эли я хяннонэиэдио 
‘зоЧлоиеЧен ло гирияеё ииношоооэ ханинеиох яолиьлоое490 и снэи #21209 


ани ан ош 
ЭМ а «Бия-1нэиАхоП» еЧАлхелихау  И| член фуг 
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Класс САСРЕЧИИ ем 


Этот класс окна представления базируется на элементе управления «поле ввода с 
форматированием» и потому поддерживает большие объемы текста и формати- 
рование. Класс СЕ«рЕЯИИеи предназначен для совместного использования с клас- 
сами СЕсРЕЯйрос и СЮсЬЕайсСпи Пет, что позволяет реализовать полноценное 
контейнерное приложение Асйуех. 


Класс СЯСПЕЧИС 


Этот класс — оболочка для элемента управления «поле ввода с форматировани- 
ем», и его обычно применяют для создания простого текстового редактора. Этим 
мы и займемся в примере Ех12а: возьмем обычный класс «вид», производный от 
С\еиш», и «закроем» всю клиентскую область окна большим полем ввода с форма- 
тированием, которое автоматически меняет свои размеры при масштабировании 
окна. Класс СЮСБЕЯИСТ содержит десятки полезных функций-членов, в том числе 
из базового класса С\иа. В этой главе мы задействуем такие функции (табл. 12-1): 
Табл. 12-1. Популярные функции класса СА/СРЕЧИСШ 


Функция Описание 

Стеше Создает окно элемента управления «поле ввода с форматирова- 
нием» (вызывается из обработчика ИМ_СКЕАТЕ родительского 
окна). 

5$елутаошРо$ Задает размер и положение окна ввода (устанавливает размер 
окна, так чтобы оно «закрывало» клиентскую области окна 
представления). 

сейутаоиЛех1 Получает из элемента управления неформатированный текст 
(текст в формате ВТЕ возвращают другие функции). 

5елутаои Лем Записывает в элемент управления неформатированный текст. 

сеМо@} Возвращает флаг, значение которого равно ТКОЕ, если текст 


изменен [текст изменяется, когда пользователь что-то набирает 
в элементе управления или когда программа вызывает 
5$е Мо ТКОЕ)]. В противном случае — ЕА[5Е. 


$еМоай Устанавливает признак модификации ТКИЕ или ЕАГЗЕ. 


себе Возвращает флаг, значение которого указывает, выделил ли 
пользователь какой-либо текст. 


5ереаийсратЕоттай Устанавливает характеристики форматирования по умолчанию. 


5$ебаеснопсратЕогтаЁ Устанавливает характеристики форматирования выделенного 
текста. 


ААА ААА АИ 


Примечание Если вы добавили поле ввода с форматированием в диалоговое 
окно; то в функции иШияапсе класса приложения надо вызвать функ- 
цию АртиЮсЬЕай. 


—[—[—————————————————————————щШЩШ—ШШДШб6&@&@О60оо—__ 


ЗРЯ они я зиэщиоа 1еэо А’неиох и чиэтииэпееА члияео 

-Ог чооль ‘ЛИУМААПУИГ МАТ они Э4АЭэ4 элиАЧиляепо4ло дэ 22110594 энхо а 
*4029Аээ4 эдолле!э4 я винэжогиан оянэи эоняон2о этиАдиляенэд ло с 

"ВИНЭНЭИЕиИ $29 элаяелоо а4лоиеен эан 

чи 0 ‘мэлэзА зи рие Зипира хожеиф эля2о492 зэлизеэя Ррээчвлру эпинеало 

ен в Чиэшиоор 5181$ эинэжоноц я чиэлевошяэ4эн этияонелол вАэлови эААТ, 

цчопеэпаЧу эпине@ло ен ‘е21хя — еляэойн инэии в ‘чореэнаЯу ди эти4эомя вин 

-эжопиЧи впил, эялоэьех я '12э[юза и мэм чинемох ончнолевопэноон ЭП онэи 
я эли4оча ‘еттхя длязоди элиепеоэ ‘рхелА чонена9у ли вАзчкопэи ‘т 


олониэн И25я0 12149 926 ++Э ен винечодиииело4н оннэя12905 `мэщд $8210 
енхо зоЧэлови изинэноииаи о шияеия хя4точо иоЧоляепэа и они иодолленэа 
ОМА 2 210084 я вочлкнже4иАон тэвиоявон еттхя е4эии4и чаовь втЯЧЭ 
кинэияелопэи о420я2 лю днэиАхоп вохэвьиило иэь ‘эл 
-эмиоц эшьАн ча ‘иодэкиаи о явлооеЧо| ‘Ахо4ло Але лоешиьо РЯ отнэи и 1иэщ 
1204 1212 чинвиоя 4оолчя «ОЦэН» — 1%2144$ м эинэьене эонаиеьен ‘олэн си и кин 
-эияеАИА нэиэице я члешоио4эн лэжои чногеяоечион иодолоя эолиж4эноэ ‘914159 
РОЭРИ 1Ха[445 ш нэиь-оАннэиээи отнэиАхой а иииэпэ4но ололе олоэиЯ ‘онпАЧл, 
ОЛЕ ЧЛЕИЭШО ОН ‘ЭлНЭИАхОЙ я домэл иояо члинеАх изинеяодилеи4оф о епояя эиоп 
ЧияетОеЕ ОНЖОИ ‘«Пия-лнэиАхО» АААтяэтихае члеяочлоиэшее сячлрониоп ииэЯ 


ппешопос э веухя виирдго4И ‘чу-ст`эиа 


Поза и! $1 Фелмраом эвешопе 
124} 30М ‘мам э4 }0 е31е диэН2 эц} 51э^09' 
124 10ди9777 т : 7} 51 51 


'ииятоиэг а естхя чииеалоЧи анеиаея ичаядэн нэкаваопэ4н 
У-ст`оиа вН ‘1оАи лнэиАхой ейтох ‘иончиляеЭн водизяонео ЭТря они я венножог 
-ОПоЕА Ччэшироа лез еИнвиох лэн олэьин винэкаваопэ4и энхо я иирэ‘енэвоия 
то Зэит5о Ч] 838 91015 ЕИнЕиох 15;у5ЧЕ21, ЯнЭИ Я ‘ЕлноиАхОГ эомиж4э!оо тэки 
-ЕА заироа 16910 они ЕИнвиоя © ‘«тнэиАЯО» и «Гия» ииЕ1У29.00 АПжэи эанне! 
тогеичоэ4эн ‘винэкявлопэ4и Анхо эчиэвияеАнен ‘чучел, оном воолэшогеная 
-2е4 олояон чинеиоу «иэинеяодилеидоф э впояя экоп» винэкаеАиА лнзиэие лиж 
-9э102 и адм лю ичнцоявиоди — винэжоки4и «Гия» вия ‘винонявлопэ4и Анхо 
и АлнзиАхог шияеня хчалоно и они 10 Инемох ехае1рой колэА4идарошии 9ч2э1е 


ес1хЗ дэми4Ц 
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Совет Редактор меню интуитивно понятен, но в первый раз вам, наверное, будет 
неясно, как вставить команду в середину меню. Просто щелкните пра- 
вой кнопкой место, куда нужно вставить команду, и в контекстном меню 
выберите тег Мех. Чтобы добавить разделитель в контекстном меню, 
выберите Илзеге Зерагагог. 


Теперь добавьте меню ТгапзЕег и определите его элементы: 


МЕС назначил новым элементам меню следующие идентификаторы в диа- 
логовом окне Везоигсе бутЬо}5. (Заметьте: \( — это символ табуляции, но вве- 
дите именно \&, не нажимайте клавишу ТаБ.) 


Меню Команда Идентификатор команды 

Еай Сеаг &ПБоситеп( Ш2_Е МТ _СГЕАКРОСИМЕМТ 

ТгапзЁег &Сег Рава Егот Роситеп(\(Е2 12_ТКАМЗЕЕК_СЕТРАТАЕКОМ- 
ДРОСИМЕМТ 

ТгапзЕег &тоге Рага ш Росштеп\ЕЗ 1[Р_ТКАМЗЕЕКЮ_5ТОКЕРАТАТУ- 
ДОСИОМЕМТ 


Добавив команды в меню, последовательно щелкните каждый элемент правой 
кнопкой и в контекстном меню выберите Ргорегиез и введите строки подсказки 


‘ионнэиэ4эн иояохо4ло 
Томэ1, ловяиеяои4и иипянАФф иоле виза ешен ‘мэм Айнеиоя эпа сни я лэвАио 
—9я чнотезо$чкой еплох и эчя4эня волэе 50) лнэиАхог еплоя ‘ээ товяаячя иин 
-эжоги4и эт; ям’ отризс тепзтд енеяоди4энэло 1иэшииоатэмио випянАф 
"ад>оо<тестхя экиеф я «инэиАмо!ь еооеия чнэгь-иипунАф элиАдилнегодто ‘3 


.]Х91-24$`ш бит359 
:оттапа 


ЗРОХ ЭлЯяеоОй МЭ $5210) Ээнхо я ини Ч’о<естхя ииеф элила 
-иляепэ4то ‘эоаветхНо ээеих я 8и141$) епил нэкь-оАннэиэдэн элчаеооГ ‘/ 


„Ч метлесцха. эрптоит 


:Амод1о 44>‘оостестхя киеф элчаеооП ‘9 


1иошиорлюрирнатралио 1 амутиИио> яитаай УАЯИЙРОЯАМУЯ1 ЛАя ат 
лиашироалвариряио АМУИИЮР  ИМЯИПРОАчуяТо Ая &@ 
енэиь-иипунАф вии Эинет900) — е1у99900 аолехлифилнэ п И 


анэнь-иипянАф эихел, 
эляяеоог и 20 ре 1хНо ээвих этиарочя ‘еэиэфдэхни оломэчколечо$агоп отон 
-Гнеиох винэкзоноо иинэшоооэ и иинэшооо> хангнеиох ихиьтооЕЯ 
-90 ехизиАмой эээвия я эхие!еоэ мт $51 члигилА $эплэдоза энляо я < 


м—— 


1иашитоориттроло1$ й Е. АМЯИПРОЧМТУЛУАЯЧО45 
мабириотрапио Ш амуиио2`ялтаай ЯННУМУМ 
АМНИПРОЧКПУЛУАЧЯЧО/15 

лиэшпооршитрамослабивщио ЧМУИИЮО2 МАНУМУЧИ, АТ 
‹ АМЯИПРОЧИОМНУЛУААЯР 
лиэштооршоррорловбир имо ЧМУИИО2 МАН$МУЧИ, 


енэиь-иипунАф кии эинето00) — в1уэчоо аолехифилнэНИ 


ланоць-иипянАф 
эляятоог и иадисТхяр зових этидэочя 'еэиэфаэлни ололочколезчосчкоп отон 
-инеиоя винэгяоноо иинэшооо и иинэо00э хан неиохл ихиьтооеа 
-90 памвстхНо эээвия я этиеиЕоэ мэтА $$) чликитА $э 1 зэдоза энхо я ф 
зу Ч$ и МУ 232 я4оленифипои 
чливБошУлюо чооль 914$ и (у 239 еваоиояо эзтед я члияонелоА элятАоеЕ эн 
——— ии не Чина нии чара уя мины Пе ры 


ся УЛ ААЯИПРОЧкпУЛУАячо $ МЯНУМУМ, а 
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ЭНХО Я ХОБЕНЕ 22 яАняиэш чИжеяи ‘УИУМААПЕИ Ма! шияеия хчалочо Апицовл, 
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'отнэи 1аинеиох иинэкэшчая иди чииеалои 
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ВООЕ СЕх12абос:: ОпМембоситеп*() 
{ 
1е (!СВоситепт: :Оп№ембоситеп*() ) 
гефигп РАЕЗЕ; 
т_зЕгТехЕ = "Не11о (Ргот СЕх12абос: : ОпМембоситеп{ )"; 
гефигп ТВОЕ 


Обработчик сообщения Еай Сеаг оситеп! очищает и 5йТехь, а обработ- 
чик обновления пользовательского интерфейса отключает (делает блеклой) 
соответствующую команду меню, если строка уже пуста. Помните: каркас при- 
ложений вызывает ОпОражщеЕЯй(еатаоситет, когда открывается меню ЕЯН. 


\0149 СЕх12абос: :ОпЕд11С1еагбосимеп* () 
{ 
м_з+гТех+. Емрфу(); 
// Отобразить изменения в представлениях 
РОЗТТТОМ роз = бетЕ1гз1\1емРо$1{10оп(); 
мп11е (роз != МИ) 
{ 
СЕх12а\1ем»* р\У1ем = (СЕх12а\1ем*) бетМехЕ\У1ем(роз); 
р\1ем->т_г1сп. Зе4М1пдомТехт(т_з+гТех{); 


} 


\у0149 СЕх12абос: :Оп/рдафеЕд1+С1еагаоситет* (ССмайТ *рСтаит) 
{ 
рСтаут->Епаб1е( ! м_з+гТех{. ТзЕтреу()); 


} 


9. Добавьте переменную типа СЕ<ЬЕЧИСТ в класс СЕх12а еи,. Отредак- 
тируйте файл Ех12а\М1еу’.В вручную или используя С!а55 У1еу’, добавив строку: 


ру611с: 
САТСПЕОТЕСЕг1 т_г1сй 


10.В окне Ргорегие$ утилиты С1а55 У1еу’ создайте в классе СЕх12а Йеи 
обработчики сообщений УМ СКЕАТЕ и УМ $Г2Е. Функция ОпСтеше создает 
«поле ввода с форматированием». Здесь размер этого элемента управления равен 
0, так как мы еще не знаем размера окна представления. Вот код обоих обра- 
ботчиков: 


11 СЕх12а\1ем: :ОпСгеате(ЕРСНВЕАТЕЗТВИСТ 1рСгеафеЗтгист) 
{ 
СВест гес\(0, 0, 0, 0); 
11 (С\М1ем: :ОпСгеате(1рСгеафе$тгист) == -1) 
гефигп -1; 
т_гтсн. Сгеафе(Е$_АУТОМЗСВОЕЕ : ЕЗ_МУЕТТЕТМЕ : ЕЗ_МАМТВЕТИВМ ! 
\$_СНТЕО ; М№$_УТЭТВЬЕ ; М$_УЗСВОЕЕ, гесф, 111$, 1); 
гефигп 0; 


= охл, иихэн когиявон энхо я и Ччазшиоа шо езеа 129 Аинемоя зэузаез, 
они ви элиЧэоая ‘ионнАтрой члчо енжной ря онои я зиэилпооа тео еИнвиоя 
винжогиЯи еяоАцЕЕ энэоп "етхя эинэжоги@и элиАдилоэлоди и элидэ00Э ст 


{ 
*(ОлЛзтроизе9 ‘чот ш)этавиз<-тПршод 
} 
(ТПршо9 *1При99)зиэшпооритезере1035494$иел1эзерапио: :метлег1х39 ртол 


:(3$1%-)А;троиз9$ ‘чот ш 
:(3х9113$ `Ш<-9049)3хэ1моритм3э9 ‘чот ш 
:()3иэшпэ00199 = 9049 *90(821х35 


} 
()зиэшпооритезерэ 015 э4зие1и0: :мэтлее1х39 ртол 


‘мотнэиАог э иичиижАэ1оо енэиоо олэнпэноон елноиои о чэоивнэи эн кинэи 
-яеАцА влноиэце эомижэноо иноэ ‘оной АИнеиох тэевошяло ‘эиэфаэлни иихчирл, 
-еНоЕЧНОЙ ИЧНИНЕИОХ ИИШОвиЯОнОО ‘хиЬто0е490 иишоя1р1291005) ‘виноияеиА 
влнэиэне иипелифипои леиф теч 9) и влноиАхой Ачо4ло я изинеяодилеи 
-4оф > вповя вион ви тохрл, 1эАЧиноя {иашиоорииралолславиидтио випянАф 


:(3$1\3)Азтроиз9$ "Чт 
:(3%9113$`ш<-9049)3хэ1моритм39э$ ‘чот ш 
:()3иэшпэ00199 = 9049 *+э04(ег1х39 

} 


() зиашпэоршое3ердэ9лэ4зие21и0 ::мэтлег|х39 ртол 


ЭН 9991 
‘эиэфаэлни иихочизтеяоечион ичнинвиох олэшовияоноо ‘ехиьлоое90 ‘винэк 
-чеАцА елнэиэие иипехмифипои теиф тэеяное 49) випянАф иэтее ‘иэинвяодилеи 
-оф о епояя эмой я 012 лэешэион и «тнэмАяой» воових енэиь-ионнзиэдэн ви 
охл, 1эАЧиноя 1иашииоршортраолавбиюдтио кипянАф ‘$ элеш ен Инвиох яох 
-иь109Е490 иинЕеШЕо ии 13 01рпз$ Теп$1д чне!ео) иипянАф хиле ихяололее 
"а4>’мэтлестхя экиеф я онэи Инемох илиьл00:400 этиАдихяегоало 11 


{ 
:(МООМТММОН$ ЧМЗ ‘903`39941 - ш03304 `3994 
‘3}9Т'3992 - 34611 ‘3094 ‘0 ‘0 ‘Чо1римз)зодморитмзе$ чотатш 
: (3994 )3Ээ43иэтт9399 
(Ло ‘хо ‘эдА1и)э7т6ио: :мэтлЭ 
{1294 39949 


} 
(А Зит ‘хо зит ‘эдАли МТП) э7т6и0: :метлесьхз9 ртол 


‘винэиявлопэани 
ЕНХО ЧЛОРиОО ОАОлнэиих огоя ОИвНиОИеЕ ОНО чООЛЬ ‘Ел, ИЗИНнЕЯОЧилеиоф > 
етояя виоп Чриёва лэА4иляэЧох хиьлоое4оо шен ‘иэнотеяовакон ихивА е4эи 
-ЕЕЧ иинэнзиви иойжех ии — ээие! и ‘енхо дэмевА ичнчиеьен колэвиопэ4но 
оанот, чех ‘кинэияелопэ4и Анхо 1715 ИМ эинэшоооэ тэвшазон змориХ 
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редактируйте его и выберите команду 5оге Рава ш Роситепе. Теперь эта команда 
должна стать недоступной. Выберите команду Цеаг Росштеп и снова вызо- 
вите команду Се! ага Егот Роситепи. 


Окна свойств 


Вы уже видели их в \У150а1 С++ .МЕТ и других современных программах для УЛп4о\. 
Этот удобный элемент пользовательского интерфейса позволяет разместить в 
маленьком диалоговом окне большой объем информации, да еще разбитой на 
категории. Пользователь выбирает страницы (вкладки), щелкая их ярлычки. В УЛп- 
4о\’з предусмотрен элемент управления набор вкладок (1аЪ сопиго!), который можно 
вставить в диалоговое окно, но вам скорее всего понадобится обратное — разме- 
стить диалоговые окна в наборе вкладок. В МЕС-библиотеке есть соответствую- 
щая поддержка — окно свойств (ргорегбу зВееб. Кстати, отдельные его диалого- 
вые окна — вкладки — называются страницами свойств (ргорепу разе). 


Создание окна свойств 
Вот как создать окно свойств с помощью инструментов \154а1 С++ МЕТ. 


1. Создайте в редакторе ресурсов набор шаблонов диалоговых окон примерно 
одинакового размера. Их заголовки — строки, отображаемые на ярлычках. 

2. Используя МЕС С!а$$ УЛлага, сгенерируйте класс для каждого шаблона. В каче- 
стве базового класса выберите СРгоретуРаве. Добавьте переменные-члены для 
элементов управления. 

5. С помощью МЕС С1а55 УЛгагА создайте класс, производный от СРгорепту5реей. 

4. Добавьте в класс окна свойств по одной переменной для каждого класса стра- 
НИЦ СВОЙСТВ. 

5. В конструкторе класса окна свойств вызовите функцию-член АдаРаве для каждой 
страницы, указывая адрес внедряемого объекта страницы свойств. 

6. Создайте в своем приложении объект класса, производного от СРгорету5рее, 
и вызовите ДоМоаа/. В вызове конструктора укажите заголовок окна (впослед- 
ствии его можно будет изменить обращением к функции СРгорепу$рее::$е ще). 

7. Запрограммируйте обработку кнопки Арр/у. 


Обмен данными в окне свойств 


Каркас приложений размещает в окне свойствтри кнопки (рис. 12-5). Учтите: каркас 
вызывает ООХ-код для страницы свойств всякий раз, когда пользователь переклю- 
чается на нее или с нее на другую страницу. Кроме того, как и следовало ожидать, 
каркас приложений вызывает ООХ-код для страницы, когда пользователь щелка- 
ет кнопку ОК, обновляя тем самым элементы данных страницы. Теперь понятно, 
что все элементы данных всех страниц свойств обновляются после щелчка кноп- 
ки ОК, и все это без программирования на С++! 


Примечание В обычном модальном диалоговом окне при щелчке кнопки Сапсе! 
все изменения теряются, и переменные-члены класса диалогового окна 
остаются неизменными. Однако в окне свойств переменные-члены об- 


Е ЭТИвиЭПо ‘СТХЯ 5 ииелооеои эжА чя ипоэ в “Н ‘иивкипяАЧлони ээне4 ииан 
-НэЖоиви 2 иияло 1281009 я (ицеЧ90э эн эшо ииоэ) ес1хя эинэжонийи эхид2009 


встхя эииюдгоди 9 921092 онмо ‘6-ст’оиа 


"стхя Шен АлооеА 
этижиопо4н чя ик? ‘колиьАкой оль ‘оневЕЯОи с-с1'оиа ен дяаоиозо енхо члеячеце 
-02 чзолиьАвен етол. ча эж мех он ‘Зосионо локеий ичнаАе!нело члиея 99 оичо 
онжои ‘оньэноу ‘изинеяоЧилеиаоф о вгояя эпоп я влфидш ихилоиэляеаех алкн 
-ЭИЕИ 1ЭЖОио чиоленоЕЧиой иоЧолом я ‘ялоиояо онхо встхя я ииягоой чи адэнэт, 


ес: хз дэмиди езонэ и 


‘энеЧяе ен водрелоо злоиозо онхо емоп ‘иипеэно эишоялрлэял00) чльниошаа и 
иоя> пине1о ви! чонэнь-ханноиэ4ои винзьенЕ члечалиьо лэжои винэшооо2 
хиь1о9Е490 ‘в1риояо онхо АиэшяеШЕО> ляэчюо эинэшооо2 эомочиоленованон члия 
-еЧизо — золнеи4ея ви нипо ‘оной эшея — @44умо олипянАФ я чавьоияя Оль 
‘аоиояо чпине@ло эээвихя ионпо я чшик опен @44уио 
члвиэпэ4поэ4эн Апотеоп и ялоиояо хепинеЧло хря вн яонэць-хманноиэ4эн кин 
-эияоноо ви! чоицеитеЧоо эжА Апоя-хаа х оль ‘эляпАотее эн ‘МАЧу Аяпоня имчито 
Ир, вевошуло ‘иипехифипои леиф тэвачовоо и @44рио отипянАф онаие Алия 
торачачя ийнрио хо29 вио молее в чапине4ло ви? поя-хаа ловачачя ‘АААу ии 
ЛО РЯПОНЯ РЛеЖЕН ИЦЭ ‘и ДНИОМ ИМ эинэшооо2 лэвьАкои ииножоци4и овя4вея 
ихНоня ИО9ОШ Эьиэш и ‘ачпинЕеА эишчноо эяп» оле — ‘золоцеий ханаиеои 
хчнь900 изинэпояои иилоиене эялоэьех я човАЯлопояохАЯ ‘члоиояо ииепинеАло 
цинэш900э иох109е490 э вочае доста чоэливияи эн '@44рио::эриадоло, отит 
-янАф оАнчивАтАия чииэпэ4ноэ4эн ‘ялоиояо чпинело эоэвия иошея я иьтооа 
-9о-опянАФф члеоинен онжоиээн ви! ‘Ау Ачпонх ииеяоЧисичиляе ча ииоя 
аамрразфройла$ чеяечя чапине ао иипелифипои леиф 
ЭгиЯОнЕлА ‘1 ии ‘И ‘винэноиеи вИАл ии чнорэня ‘эла4ояо4и чапинеАло ионаэ4я 
-НОХ ВЕ Ээ члеяоЧивияиляе чооль ‘еняиляе 1э1Аод эн эжег еноО ‘ЕПох я! Аодин-ол 
-ОУЕЯ ЭЭн в этэшииен эн ча охчнол, ицоэ ‘олэьин в с А1ААу ехпонх тэеиэй Оль 


122489 ихнонх иохьиэш 
я12и0я2 Эно я вИНЭНЭИеИ тЭвнэио ИОТОН © ‘ИОЛАЯШ я липохэдэи чапине о 
ионто эолижэпоо лэА4ипифигои чиэлеяовчной икоэ эжеп ‘водсявиаон 
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Г. 


Используя редактор ресурсов, измените основное меню приложения. 
В окне Везоигсе \У1е\ отредактируйте ресурс меню /2К_МАГМЕКАМЕ, добавив к 
нему меню Еогтае: 


ну2а - Метозой виа! + + [Фези] енз 


8 ТОВ_МАМЕВАМЕ 
О/аю9 
1соп 

{3 Мепу 
2 108®_МАТМЕВАМЕ 
АТ_МАМЕЕЗТ 


МЕС присвоило следующие идентификаторы элементам нового меню: 


Элемент Идентификатор команды 
&Пеаийи 2_ЕОКМАТ РЕЕАПГТ 
&5есйоп 12_ЕОКМАТ $ЕГЕСТОЮМ 


Задайте для этих пунктов меню соответствующие строки подсказки. 

В окне РгорегНез$ утилиты С1а$$ Узе\уу создайте в классе «вид» обработ- 
чики командных сообщений и сообщений обновления командного 
пользовательского интерфейса. В окне С1а55 У1еу/ выберите класс СЕх12 а еш 
и добавьте функции-члены: 


Идентификатор объекта | Сообщение у Имя функции-члена 


1Ш2_ЕОКМАТ РЕЕАОГТ СОММАМВ опЕоттареаий 
12_ЕОКМАТ $ЫЕСТОМ СОММАМО опЕоттии5весйопй 
1р_ЕОКМАТ $ЕГЕСТОМ ОРБАТЕ_СОММАМОЬ_ Ш ОпПрашеЕоттабаесйоп 


В графическом редакторе создайте четыре шаблона страниц свойств. 
Щелкните правой кнопкой ВС-файл в Везопгсе \Мле\ и в контекстном меню 
выберите Ааа Везоигсе. В диалоговом окне АЯ Везоигсе выберите шаблон 
небольшой страницы свойств (та! ргореку разе). Шаблоны и соответствую- 
щие идентификаторы показаны на рисунке (см. на след. стр.). 

Назначьте элементам управления в диалоговых окнах (страницах свойств) 
идентификаторы из приведенной ниже таблицы. У элемента «наборный счет- 
чик» (зр сопиго!) установите в ТКОЕ свойства Ао Виаду и 5е! Виаау Имерег. 
У переключателей (гаЧю Бииоп) ШС_ЕОМТ и Ш)2С_СОГОК установите в ТКОЕ 
свойство Сточр. Минимальное значение элемента управления ШС_ЕОМТЗГРЕ 
установите равным 8, максимальное — 24. 


‘(нэиэшая пох ичиэкияеоо!) эжин онееелоп яопиеф хиле 
эомижаэно) ‘влриозо пинв1о зорових пох колипохен эжА ха4олоя а ‘а4'АззэА 
-оза и Ч’Аззэ4оза хеииеф я элиАдиЧэнэло воэвия поя чаэ4$Кыэдола ло илан 
поязиоЧи ‘уаа4$1иоло эовия элиАдиЧэнэло ‘рте7т $$ ЭЯИ вА&чкопэи ф 

‘рабюо я Зотатиио хиьзюд 
-е4оо-отипянАФф эликопэ4иоэ4эн мэ1Д $510 енхо $э111э4ола энхо я ‘прнояен 


пах 2 хиьтэво ичнооеН РЯ аа 

аазиони ш т ЯИАЛМОХ ЭТ ЕПояя эиоП РЯ аа 
4ооэи ш Тот МОТО2 2АГ чиэлеьаияэ4эи ича4э и СЯЭЪА ас 
аизиорила ш  лооя  ямаяама ра эизэрий хожеиф сЯ2 аа 
РИА ш  ПООЯ’ ЭПУИ 21 ЭИЕИ хОЖЕИФ СЯО аа 
рояа ш ТООЯ АТОЯ 24 роз хожеиф ся2рА аа 
лиони ш т ЧМО 2АТ чиэлевоияэ4эи ичаяаэ И ТЯЭ аа 
неиь ци  ЧолехифилнеЧ и виненаедил оно 
-веннемэдэЦ 1нэмэие — эозолоиеи 


чнэиь-эчннэиэ4эи эишо!эно эляяеоо| ‘эх. Аяноня 
яАняиэш чаииеф члини!эчюо ям“ отри1б тепвтд эинэжоииэди ен чоэлиовилюэ 
егочя хвиоп я яониеф енэии вкнэиси ев ичижех ‘442'Азлэдола и ч’Аззэ4ола хеи 
-иеф я чровия иле элилоэиева ‘обрабиаоло лю эянпоявиоди эоя — рабо и 
саба ‘сабвао ‘тара лчзовия этиеиеоо ‘рлеглх $819 ЭЯИ вАечнонои ‘иэлее 


739У4—а@1 $ 3994-— “4! 


6 39у4— (4 1 39%4—д4! 


————ииии 
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см. след. стр. 
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см. след. стр. 
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см. след. стр. 
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5. Добавьте в файл Ех12а\М1е\.В строку: 


#1пс1иде “Ргорегту. п” 


6. Добавьте две переменные и прототипы двух функций в класс СЕх12а- 
Иеи). При использовании С!а55 У1е\ директива #тсшае для Ргорецу.В будет 
вставлена автоматически. 


рг1уате: 
СРопфопеее т_э$п; 
ВООЕ м_6О0егаи1{; // ТВИУЕ - формат по умолчанию, РАЁУЕ - для выделения 


Теперь добавьте прототип закрытой функции Еоттай 
\014 Рогта*(СНАВЕОВМАТ& ст); 


Перед макросом РЕСГАКЕ_МЕЗЗАСЕ МАР разместите прототип защищенной 
функции ОпОзегАрриу: 


аРх_т$9 ГВЕЗИЕТ ОпУзегАрр1у(МРАВАМ мРагат, ГРАВАМ 1Рагат); 


7. Отредактируйте код в файле Ех12а\1еу’.срр. Создайте обработчик пользо- 
вательского сообщения ЯМ _ИЗЕКАРРГУ: 


О№ МЕЗЗАСЕ(ММ ИЗЕВАРРЕУ, ОпузегАрр1у) 


Добавьте в функцию ОпСтеше прямо перед оператором тети 0 строки: 


СНАВРЕОВМАТ се; 
Рогтат (с+); 
т_г1сй. е{бегаи1 +СпагЕРогмат (ср); 


Модифицируйте конструктор объекта «вид», чтобы установить значения по 
умолчанию для переменных-членов окна свойств: 


10—2064 


:0 91п39э4 
{ 
:(42)1210--е4940т319919$39$`цотл Ш 
} эзта 
{ 
:(32)1е1104-1е4911п849049$ ` Чт” 
} (31пе}909`ш) зт 
:(45)3еш103 
‚30 МИНО-НУНО 
.(шеледм ‘.и\х% = шеледм - ЛТ99улэзпуо: :метлег1х39.. )39УН 
} 
(шелечт иунуал ‘шелеам иунузм)^ТЧ9@улэ$пио: :метлесх39 171$387 


АЛаатМя$а ИМ винэшоооэ олохочиэлеяованопн лиьлоое4о0 элчявоо[ 


(рии =| 3-184$и)эт4ви3<-т1Пршов 
:(риЗи ‘34е35и)Т9$399‘чэтиш 
‘риЗи ‘31е35и биуот 
} 
(1Прш09 *ТПрио)иотзоэтебзешлочезерапио: :мэтлег1х39 ртол 


:Отеронод‘ц$`ш 

9813 = 4118} 904 Ш 

:(..4ещ104 и0т4эт95..)э13т139$ "4$ ш 
} 
()40т199э19$3еш10-и0: :мэтлес1х359 ртол 


:()Тероной "ци 

'ЭПЫЕ = 3108} 909`ш 

:(.32щ104 31пв390.. 91311395 "437 ш 
} 
()31пе} 2012420400: :метлесрхЗ9 ртол 


‘кинеяоЧилеиаоф инвиох ихиьтоое4оо элиАЧиаяет то 


"ЭП = 3118} 909`ш 
{$143 = метла 6 
{СЕ = 92153404 Ш 'уэбе9`ш`у$_ш 
0 = 20т0ди ш`бобед`ш'ц$7_ш 
:93$1\4 = эиттлерийпа ш'себеа`ш`ц$_ш 
:9$1\3 = 5118319 ш'себе4`ш*ц$`ш 
19514 = рт084 ш'собе4`ш*цз`ш 
:0 = 34044 ш' робеа`ш ‘цз ш 
} 
(...)487ш : ()метлес1хЗ9: :метлес1х39 


м=—ыьББ 
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Вставьте, как показано ниже, вспомогательную функцию Роттаф чтобы 
инициализировать структуру СНАКЕОКМАТ в соответствии со значениями пе- 
ременных-членов для окна свойств: 


\019 СЕх12а\1ем: : Еогта* (СНАВЕОВМАТ& сР) 
{ 
СЁ. с6517е = 317е01(СНААЕОВМАТ); 
СГ. мМазк = СЕМ_ВОЕО : СЕМ_СОЕОВ :; СЕМ_РАСЕ ! 
СЕМ ТТАЕТС ; СЕМ_$17Е ; СЕМ_ОМОЕВЕТМЕ 
СР. ЧмЕТРестз = (м_5й.т_раде2.т_0Во19 ? СЕЕ_ВОЕО : 0) ! 
(м_зп.п_раде2.м_611а11с ? СРЕ_ТТАЕТС : 0) ! 
(п_эй.м_раде2.т_Б/пдег11те ? СЕЕ_УМОЕВЕТМЕ : 0); 
СТ. УНе19пт = м_5п.т_раде4. т_пРопт517е * 20; 
эм1Есв(т_зй. п_радеЗз. п_пСо1ог) { 
сазе -1: 
сазе 0: 
СР. сгТех{Со1ог = ВОВ(0, 0, 0); 
огеак 
сазе 1: 
СР. сгТех{Со1ог = В@В(255, 0, 0); 
ргеак; 
сазе 2: 
СР. сгТехеСо1ог = ВОВ(0, 255, 0); 
ргеак 
} 
зм1Есп(т_зп.т_раде1. т_пРоп®) { 
сазе -1: 
сазе 0: 
УЕ гпсру (ст. $2Расемате, “Т1тез №м Вотап” , ЕР_РАСЕЗТЕЕ) 
огеак 
сазе 1: 
э1гпсру (ст. з2РасеМате, “Аг1а1” , ЕЕ_РАСЕЗТЕЕ); 
ргеак; 
сазе 2: 
У гпсру (ст. $2РасеМате, “Соиглег № м” ‚ 1Е_РАСЕЗТИЕ) 
бгеак 
} 
СР. ОСпагЗет = 0; 
СР. БРЗЕспАпаРам11у = 0; 
} 


8. Соберите и протестируйте усовершенствованное приложение Ех12а. 
Введите какой-нибудь текст и вызовите из меню Еогта! команду РеЁаий. Вы- 
бирая страницы в окне свойств и щелкая кнопку Арр\у, понаблюдайте за сооб- 
щениями, выводимыми операторами ТКАСЕЁ в окне ОеБи®. Попробуйте выде- 
лить какой-нибудь текст и отформатировать выделенный фрагмент. 


Обработка кнопки Арру 


Вас может удивить, какой способ обработки кнопки Арр!у используют классы окна 
свойств. Переопределенная виртуальная функция ОпСоттапа во всех классах 
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Создание контекстных меню 


Контекстные меню (ВоаЧпз звопсиЕ тепи) — одна из последних новаций в пользо- 
вательском интерфейсе. Щелчок правой кнопкой открывает меню с командами, 
которые относятся к текущему контексту. Такие меню легко создать с помощью 
графического редактора и МЕС-функции СМепи::Тгас®РорирМепи. 


1. Откройте редактор меню и добавьте в файл ресурсов своего проекта новое 
пустое меню. 

2. Введите имя для крайнего слева элемента верхнего уровня и добавьте коман- 
ды в получившееся контекстное меню. 


3. В окне Ргорегиез средства С1а5$ Уе\,, создайте обработчик сообщения М _СОМ- 
ТЕХТМЕМО в классе «вид» или в классе другого окна, получающего сообщения 
от кнопок мыши, и запрограммируйте его так: 


\019 СМУЛеш: : ОпСоптех{Мепи(Сипа* р\па, СРо1и ро1п+) 
{ 
СМепи тепи; 
тепи. ГоадМепи( ТОВ_МУРЕОАТТМСМЕМИ): 
тепи. бетЗибМепи(0)->ТгаскРорирМепи (ТРМ_ГЕРТАЕТСМ ! 
ТМР_ВТОНТВУТТОМ, ро1пт.х, ро1пт.у, 111$); 
} 


Команды контекстного меню можно сопоставить обработчикам при помощи 
окна Ргорегие$ в С!а55 Уле\у тем же способом, что и команды в меню окна-рамки. 


Расширенная обработка команд 


Кроме макроса таблицы сообщений ОМ СОММАМЮ, в библиотеке МЕС есть его 
расширенный вариант ОМ СОММАМО_ЕХ. Он обеспечивает две возможности, ко- 
торые не поддерживаются для обычного командного сообщения: параметр обра- 
ботчика, задающий идентификатор команды, и возможность отказаться от обра- 
ботки команды в период выполнения, отослав ее следующему объекту в пути мар- 
шрутизации команд. Если расширенный обработчик команды возвращает ТКОЕ, 
команда считается обработанной, а если Е4/5Е — каркас приложений ищет сле- 
дующий обработчик. 

Параметр — идентификатор команды полезен, если надо обрабатывать одной 
функцией несколько связанных друг с другом командных сообщений. Наверняка 
вы найдете способы применить эту возможность. 

Мастер окна С!а5$ УЧе\у не поможет в работе с расширенными обработчиками 
команд, так что придется кодировать их самостоятельно (за скобками АЕХ_ М5С МАР). 
Допустим, [2М_2ООМ_1 и ДМ _2ООМ 2 — идентификаторы взаимосвязанных команд, 
определенные в файле Везоигсе.П. Тогда для обработки обоих сообщений одной 
функцией ОпХоот надо сделать так: 


ВЕСТМ_МЕЗЗАСЕ_МАР(СМу\/1ем, С\1ем) 
О№_СОММАМО_ЕХ(ТОМ_700М_1, 0п200м) 
О№_СОММАМО_ЕХ(ТОМ_700М_2, 0п2о0мт) 

ЕМО_МЕЗЗАСЕ_МАР() 
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Панели инструментов 
и строки состояния 


Во всех приведенных до этого примерах программ на \15иа| С++ имелись пане- 
ли инструментов и строки состояния. МЕС АррИйсаНоп \У/Л2агА генерирует код, ини- 
циализирующий эти элементы каркаса приложений, если только явно не отказаться 
от предлагаемых по умолчанию параметров РоскаЫе ТооШраг и ша Згапа$ Ваг. 
Созданная по умолчанию панель инструментов содержит графические эквиваленты 
многих стандартных элементов меню, формируемых каркасом приложений; в 
строке состояния по умолчанию отображаются подсказки для команд меню и 
индикаторы состояния переключателей клавиатуры: САР$, МОМ и $СВГ. 

В этой главе вы узнаете, как настроить для своей программы панель инстру- 
ментов и строку состояния, научитесь добавлять на панель инструментов собствен- 
ные графические кнопки и управлять их отображением. Кроме того, вы научи- 
тесь отключать отображение подсказок и индикаторов клавиатуры в строке со- 
стояния, что позволит вашей программе самостоятельно управлять этой строкой. 


Панели элементов управления 
и каркас приложений 


Панель инструментов (юо1раг) — это объект класса СЛооВаг, а строка состоя- 
ния (зсапаз Баг) — объект класса С5йжизВат. Оба класса производные от ССоттоВаг, 
а тот в свою очередь — от С\па. Класс ССоштоШВаг поддерживает окна панелей 
управления, размещаемых в окне-рамке. Окна этих панелей автоматически изме- 
няют свои размеры и положение при масштабировании и перемещении окна- 
рамки. Каркас приложений создает и удаляет эти объекты и их окна. МЕС АррИсаноп 
УЛ2ага генерирует код панелей элементов управления для производного класса 
окна-рамки, хранящегося в файлах МашЕгт.срр и МашЕгт.В. 
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ии ЖА ХХ ЖД © 


ЕКАМЕ. Это растровое изображение напрямую не изменяют — вместо этого исполь- 
зуют специальные средства графического редактора Мисгозой У15иа! 51. 


Состояния кнопок панели инструментов 


Кнопка может находиться в одном из нескольких состояний (табл. 13-1). (В б0- 
лее поздних версиях панелей инструментов есть несколько дополнительных со- 
стояний.) 


Табл. 13-1. Состояния кнопок 


Состояние Описание 


0 Нормальное — «отжата» 

ТВУТАТЕ_ СНЕСКЕР Помечена («нажата») 

ТВУТАТЕ _ЕМАВЕЕО Доступна; если это состояние не установлено, 
кнопка недоступна и изображение на ней блеклое 

ТВУТАТЕ ЫШРРЕМ Невидима 

ТВУТАТЕ ПУРЕТЕКМИМАТЕ Недоступна (блеклая) 

ТВУТАТЕ РКЕЗЗЕР Выбрана («нажата») мышью 

ТВУТАТЕ \УКАР Кнопка является последней в строке 


Кнопка может быть командной (ризбБийоп) (нажата только при щелчке, а в 
нормальном состоянии отжата) или флажком (свеск Бох Бииоп) (сохраняет со- 
стояние, нажимается и отжимается щелчком). На стандартной панели инструмен- 
тов, формируемой каркасом приложений, все кнопки — командные. 


Панель инструментов и командные сообщения 


Когда пользователь щелкает кнопку на панели инструментов, генерируется коман- 
дное сообщение. Оно маршрутизируется так же, как командные сообщения от меню 
(см. главу 12). Чаще всего кнопка на панели инструментов дублирует команду меню. 
Так, кнопка с изображением дискеты на стандартной панели инструментов, фор- 
мируемой каркасом приложений, эквивалентна команде 5ауе меню ЕШе. Обе ге- 
нерируют команду /[2_ЕЦЕ_$АТЕ. А объекту, получившему командное сообщение, 
безразлично, как оно сгенерировано: щелчком кнопки на панели инструментов 
или выбором команды из меню. 

Однако кнопки панели инструментов не обязаны дублировать меню — реко- 
мендуется определить для кнопки быструю клавишу, чтобы пользователь мог вы- 
полнить команду с клавиатуры или через \Лпао\з-макрос. Для определения об- 
работчиков командных сообщений и сообщений обновления командного интер- 
фейса служат окно Ргорегиез и С!аз$ У1е\у независимо от того, соответствуют ли 
кнопки панели инструментов командам меню. 

С панелью инструментов связан ресурс растрового изображения и сопутству- 
ющий ресурс панели инструментов в ВС-файле, который определяет команды меню, 
связанные с кнопками. У растрового изображения и ресурса панели инструмен- 
тов одинаковый идентификатор — обычно /2К_МАМЕКАМЕ. Так выглядит содер- 
жимое ресурса панели инструментов, сгенерированное мастером МЕС АррИсацоп 
УЛ лага: 


‘отнэи ииллаЧято ин и ‘волро4и днэмои я и волэвааечя но 
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Всплывающие подсказки 


Всплывающие подсказки (1оойрз) встречаются в разных УЛп4о\5-приложениях, 
в том числе и в самой У15иа1 5аю. Если указатель мыши задержать на кнопке 
панели инструментов, то вскоре рядом с кнопкой появится маленькое окошко с 
текстом. В главе 12 мы уже говорили, что элементам меню можно сопоставлять 
строки подсказки — элементы строкового ресурса с соответствующими иденти- 
фикаторами. Чтобы создать всплывающую подсказку, просто добавьте ее в конец 
подсказки для меню, начав текст с символа новой строки (\п). Редактор ресурсов 
позволяет модифицировать строку подсказки при редактировании изображений 
кнопок на панели инструментов. Для этого просто выберите изображение пане- 
ли инструментов и в окне Ргорегие$ отредактируйте свойство Рготри. 


Поиск основного окна-рамки 


Объекты панели инструментов и строки состояния, с которыми вам предстоит 
работать, связаны с основным окном-рамкой приложения, а не окном представ- 
ления. Как же найти основное окно-рамку? В $П1-приложении для этого служит 
функция СУиа::СеРатеиЕтате. К сожалению, она не работает в МОГ-приложе- 
нии, так как в этом случае родительской рамкой будет дочернее, а не основное 
окно-рамка. 

Чтобы класс «вид» работал как в $П]-, так и в МО[-приложениях, нужно искать 
основное окно-рамку через объект-приложение. Указатель на этот объект возвра- 
щает глобальная функция АхсейАрр; такой указатель позволяет обратиться и к 
элементу данных т рМат\Упа класса Старр. В МОГ-приложении код, устанав- 
ливающий т рМатУпа, генерирует МЕС АррИсаНоп \/12ага, но в $ОГ-приложе- 
нии эта переменная-член определяется каркасом приложений при формирова- 
нии объекта «вид>. Инициализировав т рМат\па, можно использовать его в классе 
«вид» для доступа к панели инструментов в окне-рамке, например, так: 


И 


СМа1пЕгате* рЕгате (СМа1пЕгате*) АРхбетАрр()->т_рМа1пипа; 
СТоо1Ваг» рТоо1Ваг = &рЕгате->т_мпаТоо1Ваг; 


Примечание Переменную т рМатУ”па следует привести из типа СЕгатепа* 
в СМатЕгате*, так как т_шпаТооВаг — переменная-член именно этого 
производного класса. Вам также придется сделать т_шпа/ТооВаг откры- 
той переменной или объявить свой класс дружественным классу СМат- 
Етате. 


Аналогичную технику можно применять для поиска объектов меню, строк 
СОСТОЯНИЯ И ДИаЛоОгГоОвыхХ ОКОН. 


Примечание В $01-приложении значение я рМатУпа еще не установлено при 
вызове обработчика сообщений ОпСтеше класса «вид». Для доступа к 
основному окну-рамке в ОиСтеше нужна функция деРатешЕтате. 


' Проще воспользоваться МЕС-функцией АхсеМатУпа. — Прим. перев. 
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Ев Рада 


В окне Ргорегие$ назначьге новым элементам меню идентификаторы команд: 


Заголовок (СарНоп) _ Идентификатор команды Строка подсказки (Ргот!) 
&Сисе р_ОКАУ_ СВОЕ Ога\м а сице\пСие 
&5ачаге р_ОКА\У/ $ОПАКЕ Ога\ а запаге\п$аиаге 
&Раиегп Ш)2_ОКА\У РАТТЕЮМ СБапзе фе рацегл\пРацего 


Используя редактор ресурсов, измените панель инструментов. Отредак- 
тируйте ресурс растрового изображения П2К_МАМУЕКАМЕ, создав новую груп- 
пу из трех кнопок: 


Редактор панелей инструментов интуитивно понятен: новые кнопки добав- 
ляются перетаскиванием на правый край панели. Нарисуйте изображение на 
кнопке инструментами ЕШрз15, Весгапе и Мпе панели инструментов Илазе 
ЕаКог. Чтобы добавить разделитель, перетащите и бросьте кнопку чуть левее 
того места, где он должен быть, — группа сместится и отделится от остальных 
кнопок. Клавиша Пе! стирает пикселы на изображении кнопок. Чтобы удалить 
кнопку, переместите ее за пределы панели инструментов. 

В окне РгорегЧез присвойте новым кнопкам идентификаторы П)_ОКАМ_СЖКС- 
ТЕ, 2_ОКА\ $ОПАКЕ и [2_ОКА\/ РАТТЕКМ. 

Создайте в классе СЕх13а\У1е\у обработчики сообщений. Выберите класс 
СЕх1За\е\ в окне Са$5 У1еху, в окне РгорегИез щелкните кнопку Еуеп($ и до- 


{ 
: (3994 `ш)этбиезэец<-9а4 
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{ 
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} 
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роС->5е1есЕ$оскОБ]ес*(ИНТТЕ_ВВУЗН); // Если переменная установлена, 
// кисть сбрасывается 


ОпрташСйае обрабатывает командное сообщение Ш) РКА СЕСШИЕ, а Оп- 
Ргаи%диате — сообщение Ш_ОКА\/ $ОПАКЕ. Обе функции перемещают прямо- 
угольную область рисования вниз и вправо, потом объявляют ее недействитель- 
ной, и она перерисовывается функцией Оп)гаиш. В результате окружности и 
квадраты поочередно выводятся в окно по диагонали. Вывод на дисплей не бу- 
феризуется, так что нарисованные фигуры не перерисовываются, когда окно 
перекрывается другим или минимизируется. 


\019 СЕх1За\1ем: :ОпОгамС1гс1е() 
{ 
м_6С1гс1е = ТВИЕ; 
п_гесф += СРо1п{(25, 25); 
Тпуа119датевест+ (т_гест); 
} 


\019 СЕх1За\1ем: :Оп0гамЗацаге() 
{ 
м_6С1гс1е = РАЁЗЕ; 
п_гесф += СРо1п{(25, 25); 
Тпуа11датеВес+ (п_гест); 


Следующие два обработчика, обновляющие пользовательский интерфейс, 
поочередно включают и отключают в меню команды Сис и 5ачаге и соот- 
ветствующие кнопки. В любой момент доступна только одна из двух возмож- 
ностей. 


\014 СЕх1За\1ем: :Оп/рдафе)гамС1 гс1е(ССтауТ» рСмаут) 
{ 

рСтаит->Епаб1е(!м_6С1гс1е); 
} 


\0149 СЕх1За\1ем: :Оп/рдатедгам$ацаге (ССмаТ» рСтаЦт) 
{ 

рСтаут->Епаб1е(м_6С1гс1е); 
} 


Функция ОпргашРацети меняет состояние флажка т_ЬРайетп на противо- 
положное: 


\019 СЕх1За\1ем: :ОпОгамРа{егп() 
{ 

п_БРатфегп ^= 1; 
} 


Обработчик ОпОрашерташРайетп обновляет элемент меню и кнопку Рацегп 
в соответствии с состоянием флажка т_ВРайетп: кнопка «залипает» или воз- 
вращается в исходное состояние, а рядом с командой меню появляется или 
исчезает галочка. 
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-422 эхэни из явпо4эц 4ха[аита1а$::12 $1115 нэиь-оипянАф члеяеня олэь эиэон 
‘кИНКО120э ихо412 А1У2990 х ПАЛО чтиьАиоп опен ‘олд, ичиипочня атинэгэдно 
чооль ‘иолиеало4и веиэвиэпэдно ихоэвииений ‘емоло волоежедооло ииняэо иИотЕ Я 


иинэгло00э ехо415 


иоРОри еяиЭвИ 
ичииж4э1оо о эиялолэя100) я винколо0э Аяо4ло лицочи4й ‘винэжоки4н или 
-еНО ЭЭЭвия ИОННОЯЕИОЧН я веИРЯченЯ ‘540721ри95:409 511 б9 нонь-випянАФф 


ЗлолРОТрит эпоори п винвоио2 иходио -6-ст ‘оиа 


.{ 
‘1498 НолУотамт @т 
“ИПМ НОУОТОМТ ОТ 
‘ЗамО`НОЛУОТамт От 
‘НОУНУча$` ОТ 


= [з20звотрит 1\тй 9т3е3$ 


{(с-ст'оиа) мел, зиивцичя винво1р0) иходао ионлАеинело и $401Рри еЯИЗЭвИ 
ЧЕВНООИИЕЕЯ 'ЧОЧолехитни иипязэ токиэпэ4но и яоэАэ4 хааохо4ло ииеЧолениф 
-итноШи лежАно лаливаоноя эилАЯИ ве ‘иинэошюооо ихоЯло вий синяэо ен тэреаевяд 
МОЛУЧРАЯХ АТ тлнелоноу 'АЧочизаитеи экиеф я тэеиеоо рае, чоптОНаау эди ива 
-ОЛОУ ‘540 051ри1 МОЯИЗЭвИ ИИхЭЭЬИЛелО ВОГовиэнэ4но винкол20) эмо@1о я иипуээ 


вИНБО1905 930415 а иипхээ эинеэиэбэдио 


1аЧАлеиявия оАгело лэет900э и они ивлнэиэне оп ияевяошои тэежЕооло веол, 
-Ох ‘винколо0э Ао ло оАНТАЕнело этиьоияло вивьено ‘винвол20Э эмоЧло я сипвИ 
-4офни илоэяня чооль ладолехипни и иин219002 АчоЧ1> :иипхээ хаяолтояэл, епих, 
ея! лэечижэтон винво1209 вхо 10 ‘хвипя2о хишоя11294.00 а тояэл чиивАло4н 
иэиноиаеЧнА поп чтечнчеехон олроЧи — въеШее оля ‘'иинэшоооэ ханИнвиохя л1э4а 
-идэнэл эн и виолезованон 10 иипви4офни 1эвиини4п эн кинво120э иход1э (6) 


вИНКО1909 ©3015) 


'золнаиАа 
ОНИ ИКЭНЕИ ВН ОПОН $И ИОНШО Шен «эвиитз» ипиаи АооЧАх еплоя ‘ияевяо 
топ иэшогеяаииоя изиноиякой ее эжхег элиегошовной ‘винэжоки4и иэинволо 
-05. 9 ИИЯ1215я4009 Я ЭИНКОл20Э 9089 они ино Оль ‘ЭлатэиеЕ и оном ииву 
-нэиэце о этиАдилнаииЧэнояеой ‘яолнэоиАЧтони иноэнгеи ен хопоня эинэпэяон 
ен зинеииня этилеЧ90 ‘естхя эинэжогиди этиАдилоэлоди и этидэо0э ‘/ 


{ 
(01933849 ш)\э9ц919$<-тприоа 
} 
(1Прш09 *1Прш99)и-93зечмелаэзердпио : : метле! х39 ртол 


ди 
ЭЗИ а «Биз-1нэйАхо» едАлхелиха\у Ир член 9/2 


ГЛАВА 13 Панели инструментов и строки состояния 277 


Приведенный ниже фрагмент кода входит в функцию-член класса «вид». Здесь 
приходится сначала подниматься на уровень объекта-приложения, а потом воз- 
вращаться к основному окну-рамке: 


СМа1иЕгате» рЕгате = (СМа1пРгате») АРхбетАрр()->т_рМа1п\па; 
СЭтатизВаг» рэтафи$ = &рЕгате->т_мпазтатизВаг; 
рэтафиз->3е{РапеТехт(0, "Строка. сообщения в первой секции“); 


Обычно длина секции сообщений составляет ровно четверть ширины экрана. 
Однако у первой секции (индекс 0) длина переменная: она не менее четверти 
ширины экрана и может увеличиваться, если в строке состояния есть место. 


Индикатор состояния 


Секция индикатора состояния связана с единственной строкой ресурса, которая 
отображается или скрывается в соответствии с логикой функции-обработчика. 
Индикатор обозначается идентификатором строкового ресурса, и тот же иден- 
тификатор служит для маршрутизации сообщений обновления интерфейса. Ин- 
дикатор Сар$ Госк обрабатывается в классе окна-рамки при помощи приведен- 
ных ниже записи таблицы сообщений и функции-обработчика (функция ЕпаМе 
включает индикатор, если активен режим Сарз Госк): 


Ом УРОАТЕ_СОММАМО_0Т(ТО_ТМОТСАТОВ_САР$, ОпУрдатекеуСарзоск) 
\014 СМа1пЕгаме: : Оп/рдафекеубароск(ССтаиТ» рбСмаут) 


{ 
рСтаит->Епаб1е( : :бе{Кеузтате(\УК_САРТТАЕ) & 1); 


-_- 


Функции, обновляющие пользовательский интерфейс, вызываются в цикле 
простоя приложения, поэтому строка состояния обновляется всякий раз, когда 
приложение получает сообщения. Длина секции индикатора равна длине соответ- 
ствующей строки из ресурса. 


Управление строкой состояния 


Стандартной строке состояния присваивается идентификатор дочернего окна 
АЕХ_ ШУ 5$ТАТИ$_ВАК. Именно его каркас приложений ищет для отображения 
подсказки по элементам меню. Обработчики сообщений обновления пользова- 
тельского интерфейса применяют три идентификатора строковых ресурсов для 
индикаторов состояния клавиатуры в базовом классе окна-рамки: 2 ИМО/СА- 
ТОК_САР$, Рр_ИУПСАТОК_ МОМ и 12 ЛМПОСАТОК _$СЫ. Чтобы перехватить управление 
строкой состояния, нужно назначить другой идентификатор дочернего окна и 
другие константы для индикаторов. 


Примечание Изменять идентификатор дочернего окна строки состояния имеет 
смысл, только если нужно предотвратить вывод каркасом приложений 
подсказок в секцию 0. Если подсказки вас устраивают, можете не читать 
приведенные далее инструкции. 
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Итак, создаем программу Ех13Ь. 

Средствами МЕС АррНсаНоп У\/12аг4 создайте проект Ех13Ъ. Последова- 
тельно выберите в меню ЕЦе команды М№е\ и Рго}есе. В качестве типа приложе- 
ния выберите МЕС АррИсаНоп и в качестве имени проекта — Ех13Ъ. На стра- 
нице АррИсайоп Туре мастера установите переключатель в положение Зее 
оситепь, а на странице Аауапсеа Ееагаге$ сбросьге флажок РипИпе апа рип 
ргемеу. Остальных параметров не меняйте. 

Отредактируйте в редакторе ресурсов ресурс таблицы строк. У прило- 
жения единственный ресурс строковой таблицы с искусственным делением на 
сегменты, оставшимся с эпохи 16-разрядных программ. В окне Кезоигсе У1е\у 
дважды щелкните значок 51$ ТаЫе — откроется редактор строк. Затем щел- 
кните пустой элемент в конце списка и добавьте две строки: 


Идентификатор строки Текст (СарНоп) 
Ш_ИМОГСАТОК _ГЕЕТ ТЕЕТ 


Ш МОСАГОК ВЮНТ Е СНТ 


По завершении операций таблица должна выглядеть так: 


12 ЕБИ_Р№ Че зресйед КехИлАпа 
12_ЕОП_РАЗТЕ 57637 — 1пзем: СйрБоаг4 согкегиз\пРазке 
_1О_ЕОП_ВЕРЕАТ 57640 — ВереаЁ {Не |а5( асНог\пВереаЕ 
12_ЕОИ _ВЕРЬАСЕ 57641 — Вер/асе зресйс кехё чиёН ЧЁГегепЕ кехИлВерасе 
12_ЕОП _5Е\ЕСТ_АЦ. 57642 — ЗафесЕ Ве епёге Фоситеп \пбеесЕ АЙ 
12 ЕСИ и№О 57643 — Ипдо Не [а5Е асНоп\пИпдо 
1_ЕОП_ВЕОО 57644 — Ведо Не ргемоияу ипдопе асЧог\пВедо 
59392 — Ном ог Ще {Не гоофа\пТодде ТооВаг 
59393 — эно№ ог Не Че хаки Ба\пТодфе экабизВаг 
61184 — СТапде Ше уипдом ше. 
61185 — СРапде фе чипдоми роявюп 
61186 — Ведисе {Не иипфоми Ко ап коп 
61187 — Етагде Ве иипдоми Ко ГиЙ ее 
.. 61188 — бийер то Ве пехЕ доситегё мупдои 
„› 61189 — бийер кю Не ргемоив доситепЕ йому 
61190 — Созе {Ле асНме ийпфому ап рготрёз ко зауе (пе доситепёз 
61202 — Кеякоге {пе иипфом о погта! $2е 
денмае Та5к Ц5Е 
ЦЕРТ 


Отредактируйте символы в ресурсах приложения. Выберите в меню Еай 
команду Везоигсе 5утбо!5. Щелкните кнопку М№е\ и задайте для строки состо- 
яния новый идентификатор П)_ МУ $ТАТИ$_ВАК, а его значение оставьте по 
умолчанию (см. рисунок на следующей странице). 

В окне Ргорег|е$ утилиты С1!а5$ Уле\уу добавьте в класс СМатЕгате об- 
работчики команд, содержащихся в меню У1еу. Выберите класс СМат- 
Етате в окне С1а55 У1еу, в окне Ргорегиез щелкните кнопку Еуеп($ и добавьте 
обработчики командных сообщений: 


Идентификатор объекта Сообщение Имя функции-члена 
Ш_МЕ\ У$ТАТО$_ВАК СОММАМО ОпмеибииизВаг 
Ш)_ИЕУ $ТАТО$_ВАК ОРРАТЕ_ СОММАМО {Т опОрашейеи$ ищизВатг 


Вставьте в МапЕгт.В прототипы функций. Вам придется добавить эти 
прототипы обработчиков сообщений СМатЕгате вручную, так как \150а1 ЗаЧю 
не распознает связанные с ними идентификаторы командных сообщений. 
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В модифицированном вызове Стеше вместо АЕХ_ ШУ 5$ТАТОУ ВАК (объект 
строки состояния, формируемый каркасом приложений) используется наш 
идентификатор строки состояния /[02_МУ 5ТАТО$ ВАК. 

Теперь добавьге следующие элементы таблицы сообщений для класса СМат- 
Етате. У15аа1 За не способна сделать это; так как не распознает идентифи- 
каторы из строковой таблицы в качестве идентификаторов объектов: 


0№_ПРОАТЕ_СОММАМО_ИТ(ТО_ТМОТСАТОН_ГЕРТ, ОпИрдате!етт) 
0№_ОРОАТЕ_СОММАМО_ИТ(ТО_ТМОТСАТОВ_ВАТ6НТ, ОпИрдатев19йе) 


Затем вставьте функции-члены класса СМатЕтате, отвечающие за обнов- 
ление индикаторов: 


\014 СМа1пЕгате: :Оп/рдатеете(ССтауТ» рСмаит) 
рСтаут->Епаб1е( : :бетКеубфате(\к_1виТтом) < 0); 
бе СМа1пЕгате: :ОпОрдатевтайт(ССтауТ» рСтаЦт) 
рсмаут->Епаб1е( : :бетКеубтафе(\Ук_ВВУТТОм) < 0); 


Заметьте: левой и правой кнопкам мыши, как и клавишам на клавиатуре, 
соответствуют коды виртуальных клавиш, поэтому при определении состоя- 
ния кнопок можно обойтись без сообщений от мыши. 

И, наконец, отредактируйте следующие функции для меню У!1еу в файле 
МашЕгт.срр: 


\0149 СМа1пЕгаме: : Оп\1емфафи$Ваг(`) 

т_ипд5татизВаг. Зпом\1пдом( (м_мпаЗтатизВаг. веф5+у1е() & М5_МТЗТВЕЕ) == 0); 
Веса1сЁауси*(); 

ых СМа1пЕгате: :Оп/рдате\/1емотатизВаг(ССта/Т» рСтаут) 

рСтаут->5е+Спеск( (т_мпаЗфатизВаг. бет5+у1е() & №$_МУТУТВЕЕ) = 0); 

} 


Эти функции обеспечивают надлежащую связь команды 5{айа$ Ваг меню У1е\ 
с новой строкой состояния. 
Отредактируйте функцию ОпО)гаи) в Ех13БУ1еу.срр. Эта функция выво- 
дит сообщение в окне представления. Добавьте выделенный код: 


\0149 СЕХЛЗЬ\М1ем: :Оп0гам(СОС» роб) 

й 
СЕх1360ос» р0ос = @е{Воситеп{(); 
АЗЗЕВТ_\МАЕТО(р0ос); 


роС->Тех+0и{(0, 0, 
"Мафсп пе зфафиз Баг мй11е уоу моуе ап@ с11ск {пе тоизе. "); 
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Внутренняя структура геБаг-панели 


На рис. 15-5 показана структура геБаг-панели и названия ее составных частей. Каж- 
дая внутренняя панель инструментов в геБаг-панели называется полосой (Бапа). 
Краешек с чертой, за которую пользователь перетаскивает полосу, называется зах- 
ватом (впррег). Полоса может иметь метку (!аЪе]). 


Захват Текст-метка 


| Ни, ГСО 


Полоса 1 Дочернее окно Полоса 2 
(поле со списком) 


Рис. 13-5. Составные части тефаг-панели 


В МЕС есть два класса, облегчающие работу с геБаг-панелями. 


Ш СКеВаг — высокоуровневый класс абстрагирования, поддерживающий добав- 
ление объектов классов С7ооВаг и СГёщюовВаг в геБаг-панели в качестве полос. 
Кроме того, СКеВаг управляет (например, посредством уведомлений) взаимо- 
действием между лежащим в его основе элементом управления и каркасом МЕС- 
приложения. 

Ш СКеВагсиЛ — низкоуровневый класс-оболочка элемента управления ВеВаг. 
В этом классе есть многочисленные элементы для создания и манипулирова- 
ния гераг-панелями, но он не так удобен, как СКеВаг. 


Большинство МЕС-приложений работают с СКеВаг; чтобы получить доступ к 
низкоуровневым возможностям, вызывают функцию-член СеЖеВатСИ1, которая 
возвращает указатель на СКеВатсиИ. 


Пример Ех13с: геБаг-панели 


Познакомимся с возможностями гераг-панели на конкретном примере. Мы созда- 
дим 50]-приложение с геБаг-панелью с двумя полосами: уже знакомой нам пане- 
лью инструментов и диалоговой панелью. На рис. 15-6 показано приложение Ех13с 
в работе. 


‚Ен Зе - УпЫНед 


Рис. 15-6. Программа Ех13с с тефаг-панелью в работе 
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списком и в окне Ргорегиез введите в него (точнее, в свойство ага) несколь- 
ко элементов данных: Опе;Гуо;Виске;Му; 5 Вое!;. Затем поместите в диалоговую 
панель кнопку и измените ее свойство СарЧоп на /исгетети. А теперь добавьге 
на панель индикатор хода процесса с установленными по умолчанию значе- 
ниями свойств. Наконец, добавьге еще одну кнопку с названием Дестетети. После 
окончания работы диалоговая панель должна выглядеть так. 


Ек13с - Мегозой Узнай С + + 3} - 513ске @0В_МЫМЕВАМЕ бе” 


Ех1Зстс* 


100_АВОЦТВОХ 
1ОВ_МАМЕВАМЕ 
Тсоп 

Мепи 

ВТ_МАМРЕЗТ 

‘кипа ТаБе 

Тоофаг 

уег5юп 


Отредактируйте файл Ма1аЕгиа.В. У150а1 са 10 не «знает», как связать эле- 
менты управления панель с обработчиками в классе СМатЕгате. Их придется 
добавлять вручную. Откройте файл МатЕгт.В и добавьте прототипы в СМат- 
Егате. 


аРх_тз9 у01а ОпВи{топ1(); 
аРх_тз9 у019 ОпВитфоп2(); 


Отредактируйте файл Ма1аЕгт.срр. Откройте файл МашЕгт.срр и создайте 
в карте сообщений записи для кнопок Вийоп1 и Вийоп2. 


ВЕСТМ_МЕЗЗАСЕ_МАР(СМа1пЕгате, СЕгате\па) 
О№_иМ_СВЕАТЕ() 
0№_ВМ_С+ЕТСКЕО( ТОС_ВОТТОМ1, ОпВи{фоп1) 
0№_ВМ_СЕТСКЕО( ТОС_ВУТТОМ2, ОпВитфоп2) 
ЕМО_МЕЗЗАСЕ_МАР() 


Добавьте методы ОийВийоп1 и ОпВийоп2 в СМатЕгт.срр: 


\019 СМа1пЕгаме: : ОпВи{оп1 () 
{ 
СРгодгез$С1г1 * рРгодгез$ = 
(СРгодгеззС+г1* )т_мпа019Ваг. бет 019Т+ет(ТОС_РВОСВЕ$$ 1) 
рРгодгезз->54ерт\(); 
} 


\019 СМа1пЕгате: :ОпВиоп2() 
{ 
СРгодгез$$С{г1 * рРгодгез$ = 
(СРгодгеззСг1* )т_мпа019Ваг. 6е{019Т+ет( ТОС_РВОбАЕ$$1); 
1пе пСиггеп{Роз = рРгодгезз->бе{Ро$(); 
рРгодгезз->5е1Роз (пСиггеп{Роз-10); 
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Повторно используемый 
базовый класс окна-рамки 


Язый С++ позволяет задействовать «конструктор» из программных блоков, ко- 
торые можно запросто брать «с полки» и вставлять в новые приложения. Прекрас- 
ный пример этого — классы библиотеки МЕС. В этой главе мы рассмотрим, как 
создать свой повторно используемый базовый класс на основе библиотеки МЕС. 

Работая над таким классом, вы узнаете много нового о \/т4оу\з и библиотеке 
МЕС. В частности, вы увидите, как каркас приложений обеспечивает доступ к ре- 
естру УЛп4оугз, разберетесь в механизме работы класса СЕтате\па и расширите 
свое представление о статических переменных класса и о классе С5йтв. 


Почему так трудно создавать повторно 
используемые базовые классы 


В обычном приложении пишутся программные компоненты, предназначенные для 
решения конкретной задачи, и единственный критерий «истины» — требования 
к проекту. Однако, создавая повторно используемый базовый класс, нужно учи- 
тывать будущие потребности — как свои, так и других программистов. Класс дол- 
жен быть не только универсальным и законченным, но эффективным и простым 
в работе. 

Разрабатывая пример для этой главы, авторы воочию убедились, насколько 
трудно создавать повторно используемое ПО. Хотелось написать класс окна-рамки, 
который «запоминал» бы размеры и позицию своего окна. Вскоре выяснилось, что 
существующие УЛп9о\з-программы запоминают еще и состояние своего окна: 
свернуто оно в значок или развернуто во весь экран. Вдобавок обнаружился ка- 
кой-то странный тип окон: и свернутых в значок, и развернутых в полный экран 
одновременно. Еще надо было позаботиться о панели инструментов и строке со- 
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вотэвичв еПлэзя вхие-онхо ‘Эду изинеяованонпои о ионнеэипен ‘иинэжокиаи 
-1а$ Я &(мэ 392151512) ропэ огоннкошрои эовия чтепеоо эн ололе олзэия 39 АИЭБОП 
ридщешрано неончя еняо олоннколоон кий воэвия ОДОЯО5ЕО Эятоэьех я Аизьой 


эшел-1эзелцу неиь-випунАф и римэшел-1 ему 


'ЭштлНиа1515 ла ен винэжопиЧи ихие4-енхо эээвия ионпояеи 

-оЧи я рижашилно члиноиее — ‘аленопо онжАн оль ‘ээЯ ‘илиня иоле си яо4эиидн 
в эноиь ио1 я ‘винэжони@и-[(4$ отодог ки! нэполи4и илие-енхо ээвия тоте 

чиие4ло4и винош4эяее тноиой ен ээшяеяоявлоэшко ‘илива 

-ЕНХО ЭИНВО1209 тэЕЯиияене1290Я и 412294 си стипвидофни Але повячлиьо эин 

-эжониЧи эмэдиеЕ иэшопоно иа ‘э4аээ4 я огипеиаофни оАннеЕЕЯА лэвнвАхоо 

‘ал: 14915549 Ээвих влэвкноии4н иодолоя я ‘эинэжоки4н ‘АлоовА веш4эяес 

"вИНЕО1205 ихо1о и яотноиАЯтони инэнеп илромипия эинво120) и эинэжононоЕЯ 

эинво120э эолАняэ 

‘эинкО1209 эолАнаряЕв А 

‘эинэжогои 01э 

‘нло Чэиева 


ихитриэляеех эишойтоно ээпогениионее ‘киножоки4и 
таб АхивА-онхо (1191915124) оинношрои лэвяижЧэон 9417441491515 4910 ЗОВИ РИМ 
-Эир4-]) ло уланпояЕИОЧИ ‘9412411491515 421) ИОЗОвИХ Э ЭлэвлоовАон пая эяеил иоле Я 


ЭшЕе/-}Иэ]$!$124 ээеиу 


‘иметох вечиэн яря 12149 чолнэнониох хчниие они хчиэАванопои ондоляон хит 
-БОЛОРН ВУЭЧОИиОИ9 БЕННЭЯ12905 ‘Е294ээя изинеяодиииеАло4и вочлединее игиш 
-э4 ча ииээ он «ё2овия имяоето я чтикэтая одии-оль ии веацэн у» :лоэо4ноя чэк 
-РЯЕШЕЕ ЭН ЧЧоЕиЯ ЗИШО яд ШДо «атиявлоя и члесэаа» эинэшАхри ашоваячиачиои 
ЕИчэя иоле иаИ ‘ололАЧИ ви! говно и 14459 “еляэои олонШо вши ичнноияол, 
-о.ИГОИ ‘Эви ‘иедлоЧн кине!ео) изип ичнаивион я колотеяаэина эн ОАТОвЬЕЕ 
мови эчяоЕе9 эчизАвчнопои ондоляон ой эхлооваевА ионнэкпичиоди иап 
онжоио 
оншеЧ1о чооиеевяо АлоиииеЧло4и волэьохее оть ‘эЭя 199 иеиэг иа4олох ‘илие-еняо 
Зовия члвоииен ‘эБо4оу Та я ивлоов4 эовия чооль ‘вочлиоог ‘олол, эмоЧЯ ‘и винколо 
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Если переопределить функцию АсйошеРтате в производном классе, можно 
изменять значение иСта5рои перед передачей его в функцию СЕгатепа::Асйожще- 
Егате. Кроме того, можно вызвать функцию С\Упа::5ейУтаошРасетети, которая 
устанавливает размер и позицию окна-рамки и позволяет указать, должны ли в 
нем присутствовать панель инструментов и строка состояния. Поскольку все из- 
менения выполняются до того, как окно-рамка становится видимой, на экране не 
возникнет неприятного мелькания. 

Нужно позаботиться и о том, чтобы не инициализировать повторно положе- 
ние и размер окна-рамки после каждой команды ЕШе М№е\ и ЕЦе Ореп. Для этого 
служит переменная-член — признак первого вызова, проверка которого гаранти- 
рует, что функция СРегяЯетиЕтате::АспожщеЕгате вызывается только при запуске 
приложения. 


Функция-член РгеСгеаеИ/таом 


РгеСтеше\"таош, объявленная в С\па, — еще одна виртуальная функция, которую 
можно переопределить, чтобы изменить характеристики окна до его появления 
на экране. Каркас приложений вызывает ее перед АсйошеРтате. Мастер МЕС АррИ- 
сайоп УЙгагА всегда генерирует в ваших классах «вид» и ‹окно-рамка» переопре- 
деленную функцию РгеСтеще "то. 

В качестве параметра этой функции передается структура СКЕАТЕУТКОСТ, в 
которой есть две переменных-члена: $1/е и ЯшЕх5Рле. Вы можете изменить их перед 
передачей структуры в функцию РгеСтеше "та! из базового класса. Флажок 5 /е 
определяет, есть ли у окна границы, полосы прокрутки, кнопка сворачивания окна 
и т.п. Флажок @фЕх5 ре управляет другими характеристиками, в том числе рас- 
положением поверх остальных окон. Подробнее об этом см. в разделах УЛп4о\ 
556$ и Ежепаеа УЛпдоу“ $1у1ез интерактивной документации по библиотеке МЕС. 

Элемент 152С/а55 структуры СКЕАТЕЗТКОСТ позволяет изменять кисть фона, 
курсор или значок окна. Изменять курсор или фон для окна-рамки бессмыслен- 
но: его клиентская область закрыта окном представления. Если вы, к примеру, 
захотите создать окно представления с жутким красным фоном, переопределите 
РгеСтеже"тядои) для класса «вид»: 


ВООЕ СМу\1ем: :РгеСгеафе\1 пдом( СВЕАТЕЗТВУСТ& сз) 
{ 
1 (1!С\М1ем: :РгеСгеатем1пдом(с$)) { 
гефигп РАЕЗЕ 
} 
С$. 1р52С1а$$ = 
АРхВед1$+ег\\п9С1а$$(С5_ОВЕСЬК$ | С$_НВЕОВАМ | С$_\ВЕВВАМ, 
АРхбетАрр( ) ->1оа9Сигзог (ТОС_МУСИА$ОВ), 
: :Сгеате5011аВги$й(В@В(255, 0, 0))); 
1Е (с3.1р$201аз$ != МЕ) { 
гетигп ТВУЕ 
} 
е1зе { 
гефигп РАЕЗЕ 


‘(ор ‘.5зитоа. ‘.Витазешлод зхэц.. )зитэттзолчезтам<-( )49удэ9ху 
‘(.иешон зэшт1. ‘.3004. ‘.битЗзешао: зхэ.)битааэттуолчезтаМ<-()9аузэ9х4у 


ох иояел, лэжои зуитоа и заод 1а4ломе4ен члияонелоА э4эи 

-иди иэшАшаиэаи я '4улаох/у випянАФф венчиеооцл члиьАиои тэвиояеон оля ‘инж 
-оииЧи-1яэч00 ен чиолеЕеЯА ножАн ‘Атоээ4 я епАлрой иипянАф чатяечя чооль 

'зтатоа и 140 

— чалриеаеи в ‘Зи ето} 1ха1, воиеечеен еиэпееАтон А эочалхат э4экиди иэшАг 

чи $ 'еЧ1рээ4 ватоие4еи и виопев он енэми вототеп4эн ивипянАф иэоя ‘ии 

-винечосеЧооэАи кочлкнеЕ и иипянАф эчяохо41о члеяовяиконои колэпиаи ‘иолвиее 

иэшогенеии о винэьенЕ э412ээ4 я члинеАхоо онжАн ино ‘вяене 29 впоиь эчиэп 
явл одии ‘814152 чамэчюо ея одии э412ээ4 а эчнни! лодллеал иипянАф ит@ 


"Виола 

9141 б9Ол 129 

ашолао лм 

‘аула 

‘еЧлрие4еи иэнаии о и еиэпее Атон иэноии о ‘княо4А хинжин вяй товиэпэ4но иип 

-ЯНАФ «эчя0412э24» эжин эчннэиоиьэ4эи в ‘иихае4эи чнояодА иинх4эя тэвиэиэа 

Но (24445190125 иипянАф Члэме4еи ичяохо1 ‘зморит элоиегех я чииеф-и е 
‘зморигл 412э94 эн чтеяоечионои 12149 эинэжоцийи ‘атике!А яоячя толе ииоя 


:(( „зиотзеоттаду рэзелэи99-рлехтмаау теэол..) 1” )АэуАиззтбэнаэс 


лалиело4и азии иипянАФ я (2У44451894195::Ддтии5 яовная 1эА4иэнэл 
рлезтм, чопеоиаау эзи ‘вокиеф-1И нэмэ4я оэ эшэ воэишяине4хо> ‘ЧЧущ => 
вия внэиь-иипянАФ рф тэвияелоопо4и ехэтоиноио-Э И А91э94 х виАлоой ви 


ОЕ = $3ит0а 
УеШоН ЗЭШТ[ = .}404 
бут34е110} 3х91 


90844Х31 


:иоле эпоая вААляАЯто волиь Ако ‘эиэпевА поте я иихаеЧэи вняоак 
ея! лэвяиждэшюои эинэжонии в ‘(эиношоЯнА ‘оньэноя ‘оле) энэшевА иояэнаоя 
я воливенЕ чиие4ло4и вии члоАИ ‘елфиЧш олоннеяованопои олэниэноон аэиввА 
и Пиу 9912554 я члинеАх «тэьох» Эочалхял, Чоэээподи ичаолояол ‘иилоАно 

‘иевБошя ичняело 
-05 оп волэкиялоэшАэо иоЧолтохя ипанне! ипаяоноиь и иаяохзо4ло я иАлоог ‘анне! 
еЕЕ9 веяоэвихае4ри хех нечовинел4о Члоээа ‘винэнвАх олоннэаиэдяо.шой кий слипеи 
-офни члешоиоп 1Алои чиие4ло4и эчнчиэйло и 90 еАх зморигх хчиэАдиноал, 
-нох ‘яогиеф хчниэлоио 4ооден — Члоээ4 чаеяосаяионои ололе олоэия тэАИномояэа 
ЗЗ05ОЗОА ОН ‘хвинэжоииЧи-сситл\ а и чакнэии4и онжои хи ‘имение Ф-и 2 чиох 
-вне ‘онлвоЧэя ‘ол, ‘змориг\ иониваее4-9т ви? иивинэжогиаи Э ииелоова ая ииоя 


$морш!/М 419ээа 


‘'иипхнАФф ха! хиле эичариэполиеея члеиАпои опен еплот, он ‘алииопэ4ноэ4эн 
еяоно онжои поршдатолоал олипянАФ хеоэвих ханиоявио4и я ‘онвэноу ‘оовия 
и9Я05Р0 Я ИИЧННУЖОиЕЕ ‘имеялриояо чаеИеноо лАШАО чорэвия ханпоявио4и хээя 
енхо ‘ихивА-еняо олоннколрон эоэвия я поршдаталоала члииэпэдноэ4эи инэя 
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Ипсоде_ 


Для кодирования всех символов. ровойокии языков ее том. числе с диак- 
ны речи хватает 8 оеы большинство азиатских Языков _ 


ты вида тронет р нами 
без. о символа. т _ ›мпилятор. сгенери-_ 
( НАК) и ее на 


ие функции | 
— Ре в а _ 


казано в главах 
о миаз 
о - 


В примере Ех14а вы претит с реестром, научитесь реое-ьв оарарииии и ре- 
дактировать его с помощью программы Кезеаи. 


ох иохел, ондэмиЯн этэшинен 1чя импэя ‘814169 эл, 
-1Э9.00 я мецочиио я ПАТООЙ иоивАн вокиоопенон иея ‘иилоАпо[ ‘ эиневейи4и 
ААА ААА ААА ААВ ААА ААВ АЗ НАА ААААВАААА 


: (1%9126е$$э/13$ )ходэбеззэих4у 

(104434 ‘.р% лэдшпи 10443. )3е1410-'3х9196е$$9/.1$ 
:]Х9196е$$9/23$ бит1359 

66 = 40443и Зит 


:424404::8и14459 випянАФ дэвшоа АвешеЕ Але ‘молеидоф упаннэнои 
-24цо 5 иия121291002 я АчоЧло члеяоЧи4эноло опен оль ‘лижокошгэди чАэна1, 


. (1хэ1э96е$$э/.11$)хозэбеззэих\у 
.(..10449 умоихий.. )3хэ196е3$э13$ бит11$9 


РЕ ИЦИ 


: (1х91э6е$$э/7$)хозэбеззэих\у 
:.10449 умочУий., = []3хэ1э6беззэ\7$ лецо 


ув, члечеча онжои хоЯаб$аих/у 
(‘+4042 15И02 вип чиэлиноиее 
эроэрай 2 ичиилозияоо ® ‘5414462 112900 вн чиэлеееЯА эн оле — 4191241 :эаяариее) 


:(0 = Отэнати 1мтй 

‘10-8 = ЭЧАЦЫ 1АТП ‘3Х912$9Т Н151997)ховебеззенхуу та\ухзм зит 
'чопихотоЧи Э2 си нипо 108 ‘хоЯа855их/у отипянАф оАнчиеоонл изичвоЯ ‘+4242 
1502 епил, яодлоие4ви тощо. эди ияэлоипои9 иипянАф эилони анозиио ен чцэл, 
-ЕЕВЯА я 544.41) 119900 иишомЕвооэаи ‘() *404 15и02 Чоле4эно что 814469 эоэвия 
Я ‘О9лОЕЬ Я 'хОЧло иивинэнатлоно4и иииоодо э члелоов4 члоиА анжиой чииел 
-оЧи Амотеоц чачирови иле вн волотеленон Аиэнжэди-ои ихэтоинкоио иона Аейнело 
иипунАФ эилони “чад ‘эпнох а иэнАн о зонояиио лачирови эаньмоо — вплолин и 

814152 вамэчюо 199 ииеяоЕчионои ей эоя ++) ен чииеало4н э4ии иончивоги я 


виневодиохэтни випедэно // :(.л, == [2]43п4121$)143$&\ 
:(эше№1$41-43$ == (6)3491'43п4111$) 1435$ 

‚(.элтте эт АэТ$944 $ТЛТЗ., == Ч314143$)14395\ 

А ь 8% 1435 

випенелехноя // :91е№1$е1118 +. + 91е№1$414415 = 4411141$ бит41$9 
: (.Аэт$эла..)эшем1$е1213$ 6ит4159 

:(.ЗТлТЗ..)91е№3$1-41$ 6412159 


9444490 я0лмэ900 винеяосчнопои яодэии4и ханьипих, оманохлээн 
тоя ‘ихоЯто э4риееА о тодее 10 овя лэвияеоси оте ‘члиимеп чтвиошая изоэвииений 
ч12он90эоно — озлониолэоГ ол эонявих ‘омигия ‘он ‘чонэць-иипхнАф и яоЧолеЧэно 
хэчнёэцоп олони 95414450 воэвия д '++0 жчев тэв4ишова ончиэтиьене 814167 ээвия-Эи 


би!1159 ээеиу 


"З57Т ЭП 3922э4 энэпевАтои я яок 
-иеф хчая4яло хинэироп хорипо тэвнехор иинэжони4и эея4ея эиневеииЧи 
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С5г1п9 $1гТезт(“{езт”); 
эЕгпсру(з{гТез&, “Т”, 1); 


компилятор сообщит об ошибке, так как первый параметр $й'исру объяв- 
лен как саг», а не сот! сраг*. Функция С5йтв::СеВи]ег фиксирует за- 
данный размер буфера и возвращает срфаг*. Чтобы потом вновь сделать 
строку динамической, вызовите функцию-член Кееа5еВиреи. Вот как пра- 
вильно заменить строчную букву # на прописную: 

С54г1п9 этгТезт(“{езт”); 

$Егпсру(з1гТезт. бетВиРег(5), “Т”, 1); 

эфгТехт.Ве1еазеВи!Рег(); 

АЗЗЕНТ($гТез{ == "Тез+"); 


Оператор соп5! сраг* преобразует объект С5йтив в указатель на константу; но 
как быть с обратным преобразованием? У класса С5й7ир есть конструктор, преоб- 
разующий указатель на символьную константу в объект С5й/ их, и, кроме того, набор 
переопределенных операторов для таких указателей. Вот почему допустимы та- 
кие выражения, как: 


Тгифп += ” 1$ а11уе”; 


Специальный конструктор работает с функциями, принимающими ссылку на 
С5ттв, например с СОС::ЛехЮш. В следующем примере в стеке вызывающей про- 
граммы создается временный объект С5й/ив, а его адрес передается в ТехЮиё 


р0С->Техе0и{(0, 0, “Не110, мог1а!"): 


Если надо самостоятельно подсчитать число символов, эффективнее исполь- 
зовать переопределенную версию СОС::1ТехЮий 


рОС->Техе0и{(0, 0, “Не110, мог19!”, 13); 


При написании функции, принимающей строковый параметр следует соблю- 
дать несколько правил. 


Ш Если функция не меняет содержимое строки и вы собираетесь работать со 
стандартными библиотечными функциями, такими как 5#сру, используйте 
параметр соп$Ё сраг*. 

Ш Если функция не меняет содержимое строки, но вы хотите вызывать в ней 
функции-члены С5#тв, используйте параметр соп5{ Сбйтве. 

Ш Если функция меняет содержимое строки, используйте параметр С$тия®. 


Полностью развернутое окно 


Окно в УЛ 90\у$ можно развернуть либо через системное меню, либо щелкнув 
кнопку в его правом верхнем углу. Аналогично можно восстановить окно (вер- 
нуть его к исходному размеру из развернутого состояния). То есть развернутое 
окно «помнит» свои исходные размеры и положение. 

Экранные координаты окна возвращает функция Сей/таоишКес! класса Спа. 
Если окно развернуто, она сообщает размер экрана, а не координаты окна в не- 
развернутом состоянии. Чтобы класс постоянного окна-рамки работал с развер- 


11—2064 


чтираал ‘отинвьнойй оп хинчиолАоивАн ичннояо ичннэял290) нэнь-оАннэиэа 
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иэинеяо5анопои э оннойи колэАдиАатонох ве4охтоя ‘рижашлно еээвих пив/э(иал 
энэиь-ионнэиэ4эи иохоэьилело я волиж4эпоо хинчнолАоивАн ивч9оэо иоме|, 
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с фиксированным размером и положением, скрывая тем самым переменную ба- 
зового класса. 


Пример Ех14а: класс постоянного окна-рамки 


Программа Ех14а иллюстрирует применение класса постоянного окна-рамки 
СРетяетЕтате. На рис. 14-1 показано содержимое файлов Регз15Е.Н и Регз15(.срр 
из проекта Ех14а на компакт-диске. В этом примере мы вставим новый класс окна- 
рамки в $П1-приложение, сгенерированное МЕС АррИсацоп У/гага. Ех14а — это 
«ничего не делающая» программа, но класс постоянного окна-рамки можно лег- 
ко перенести в другое 5$П[-приложение, которое делает что-то полезное. 
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см. след. стр. 
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5. Измените Ма1аЕгт.срр. Проведите глобальный поиск и замену всех вхож- 
дений СЕгате\па на СРегячетЕтате. 


4. Отредактируйте Ех14а.срр. Замените строку: 
бе{Вед1$+гуКеу(_Т("”Ёоса1 Арр\1тага-бепегафед Арр11сат10пз”)); 
на: 


бетНед1:{гуКеу( "Ргодгатт1п9 \1зиа1 С++ .МЕТ”); 


5. Добавьте файл Рег$1$1.срр в проект. Вы можете вручную набрать текст фай- 
лов Рег$15.В и Рег$15срр по листингам или скопировать их с компакт-диска. 
Но наличия этих файлов в каталоге \усрр32\Ех14а недостаточно — вы долж- 
ны добавить файл реализации в проект. В У15иа! С++ .МЕТ из меню Рго]есе вы- 
берите команду Ааа Ех15Ипе Цет и в списке файлов — Рег$15 В и Регэ19.срр. 

6. Соберите и протестируйте приложение Ех14а. Измените размер и поло- 
жение окна-рамки и закройте приложение. Перезапустите программу и про- 
верьте, располагается ли окно на том же месте и сохранились ли его размеры. 
Поэкспериментируйте с разворачиванием и сворачиванием окна программы, 
затем отключите панель инструментов и строку состояния. Запомнило ли по- 
стоянное окно-рамка новые параметры? 

7. Просмотрите реестр Улп4о\5. Запустите программу гезеаИ.ехе. Перейдите 
в раздел НКЕУ_СОВВЕМТ О5ЕВ\5боЙутаге\Ргоэтатите \У151а1 С++ МЕТ\Ех 14а. Вы 
должны увидеть там параметры, аналогичные следующим: 


КеуБоаг4 ГаусиЕ 


|(беРацк) ВЕб_52 (уаше по зе) 

коп РЕб_О\ЮВЮ — 0х00000000 (0) 

пах ВЕб_Р\УОВО  0х00000000 (0) 

ес РЕб_52 0222 0097 0575 0490 


Ветокейссе55 
‘ЗоНумаге 

Ве Расог Меню 
Я а5зез 

Кодак 

1оса/ Арр\Игаг4-бепегаед Аррйсай 
{3 Меговой: 

'Месаре 

Мсо МаК Сотринп 


. ех14а-ВагО 
{3 ех14а-Ваи! 
ех14а-биттагу 
ВесегЕ Рйе Ц5Е 
5епдз 


Обратите внимание на взаимосвязь раздела реестра и параметра «Ргозгати!1е 
\У150а! С++ .МЕТ» в функции 5е Жест уКеу. Если в качестве параметра 5е/{КеятуКеу 
задать пустую строку, имя программы (в данном случае Ех14а) будет расположе- 
но прямо в разделе Зойхаге. 


Постоянные рамки в МО!-приложениях 


С МО!-приложениями мы начнем знакомиться в главе 16, но если вы используете 
эту книгу как справочник, вам может понадобиться технология работы с посто- 
янной окном-рамкой в МП]-приложениях. 
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хиозэ эинэжоноп и ч4эиееА чтенииопеЕ ондоэоно эиножокиди-аи оль иене 
оле у 'РиИЛИЧОТаило чоляэчюо вип волэеяченяя эшилдатацу випянАф охенпОо 
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нэиь-випянАФф виво в ‘ошилнатацор випянАф кенчиеАтАия эн тэвячечя винэжоциди 
аи ихие4-енхо отоняоно 20ри1а104$ отипхнАФ хех мет, ‘1эПАо эн члелоова иин 
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ЭМ а «Биз-1нейАхоб» едА1хелихау иИ| члэен 00$ 


ГЛАВА 


15 


Документ 
и его представление 


В данной главе мы наконец рассмотрим процесс взаимодействия документа и 
его представления. Первое впечатление об этом процессе вы получили в главе 12, 
когда речь шла о доставке сообщений объектам «вид» и «документ». А здесь вы уви- 
дите, как объект «документ» хранит данные, обрабатываемые программой, а объект 
«вид» представляет их пользователю. Вы также узнаете, как объекты «документ» и 
«вид» обмениваются данными при выполнении программы. 

В обоих примерах этой главы для классов «вид» в качестве базового использу- 
ется класс СРоттИеи. В первом, предельно простом примере документ содержит 
единственный объект класса СУшает, представляющий одну запись о студенте. 
Окно представления отображает имя и общий балл студента и позволяет их из- 
менять. Работая с классом С5иает, вы научитесь писать классы, отражающие 
объекты реального мира, и работать с функциями диагностического дампа биб- 
лиотеки МЕС. 

Второй пример расширяет первый, вводя классы наборов указателей, в част- 
ности СОБМ5Ё и СТуреаРИА$, что позволяет хранить в документе набор записей 
о студентах и обеспечить просмотр, вставку и удаление отдельных записей в окне 
представления. 


Функции взаимодействия «документ-вид» 


Вы знаете, что объект «документ» содержит данные, а объект «вид» представляет 
их на экране и позволяет редактировать. В $О1-приложении есть класс «документ», 
производный от СРоситет, и один или несколько классов «вид», каждый из ко- 
торых в конечном счете происходит от Се. Документ, окно представления и 
остальные элементы каркаса приложений взаимодействуют весьма тесно. Чтобы 
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в этом разобраться, надо познакомиться с пятью важными функциями-членами 
классов «документ» и «вид». Две из них — невиртуальные функции базового клас- 
са, вызываемые производными классами, остальные — виртуальные функции, часто 
переопределяемые в производных классах. Рассмотрим их по порядку. 


Функция СИеи::деоситет 


С объектом «вид» связан единственный объект-документ. Функция Сеоситет 
позволяет получать указатель на документ, соответствующий данному окну пред- 
ставления. Пусть объект «вид» получил сообщение о вводе пользователем новых 
данных в поле ввода. Он должен уведомить об этом документ, чтобы тот обновил 
свои внутренние данные. беШоситетй возвращает указатель на документ; через 
этот указатель можно обращаться к функциям-членам или открытым переменным- 
членам класса «документ». 


Примечание Функция СРоситет::СецУех Йеи» позволяет перейти от документа 
к представлению, но так как у документа бывает несколько представле- 
ний, ее надо вызывать в цикле для каждого из них. Впрочем, прибегать 
к бей\ехТеш придется нечасто — каркас приложений предоставляет 
более эффективный способ перебора представлений документа. 


Генерируя класс, производный от СИеш, МЕС АррИсацоп \У/тагА создает спе- 
циальные версии функции СеШоситет — с поддержкой отладки и без — для бе- 
зопасного приведения типов; она возвращает указатель не на СРоситепь а на объект 
производного класса. Версия без поддержки отладки (содержится в заголовочном 
файле) выглядит примерно так: 


111 пе СМубос» СМу\1ем: :бетбоситепЕ() сопзт 
{ гефигп ге1пфегргет_сазт<СМудос*>(т_рбоситеп{); } 


Версия с поддержкой отладки (хранится в исходном файле представления и 
компилируется при включении отладки) имеет такой вид: 


СМубос» СМу\1ем: : бетбоситеп*() сопз+ // версия без поддержки отладки 
//является встраиваемой (1п11пе) 


АЗЗЕАТ (т_рОбоситеп{->Т$К1па0т(ВУМТТМЕ_С1А$$(СМубос))) 
гефигп (СМубос» )т_рОбоситеп*:; 


Встретив в коде класса «вид» вызов Се Доситепь компилятор вместо СУеш::Се1- 
Роситеть, возвращающей СРоситепй*, использует СМутеш::сеоситети, которая 
возвращает СМуБоситет*, поэтому вам не надо приводить возвращаемый указа- 
тель к производному классу документа. Без подобной вспомогательной функции 
компилятор вызывал бы функцию базового класса бСеосите и возвращал ука- 
затель на объект СРоситейЕ. 

Следующий оператор всегда вызывает функцию базового класса Сеоситет: 
независимо от наличия указанной вспомогательной функции, так как функция 
сте: деоситетй не является виртуальной. 


р\1ем->бетВоситеп*(); // р\1ем объявлен как С\1емх 
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Функция СВоситет::ОрдаеАП\Иеи/$ 


Если содержание документа почему-либо изменилось, надо уведомить об этом все 
объекты «вид», чтобы те обновили представление данных. При вызове ПражщеАШИеихз 
из функции-члена производного класса документа ее первый параметр р5епаег 
равен М. Если же она вызывается из функции-члена производного класса «вид», 
параметр р5епает указывает на текущий объект «вид»: 


бе{боситеп* ()->ИрдатеА11\1ем$ (1101$); 


Значение параметра, отличное от МИ, позволяет каркасу приложений не уве- 
домлять текущий объект «вид» — предполагается, что он уже обновился сам. 

У этой функции есть необязательные параметры, через которые можно пере- 
давать объекту «вид» характерную для приложения информацию о том, какие части 
представления обновить. Это более «навороченный».способ применения функции. 

Чтобы узнать, как именно уведомляется объект «вид» при вызове ОражщеАЙИеи», 
познакомьтесь с функцией ОпОраае. 


Функция СИеи::ОпИразе 


Эта виртуальная функция вызывается каркасом приложений в ответ на вызов 
программой функции СРоситет:ОращеАШеи». Конечно, вы вправе вызывать ее 
прямо в своем классе, производном от СУеш. Обычно ОпОраше производного 
класса обращается к документу и, получив его данные, либо обновляет перемен- 
ные-члены класса «вид» или соответствующие элементы управления, либо объяв- 
ляет часть представления недействительной, что заставляет функцию Ойбгаш 
перерисовать часть окна по данным документа. ОпОраше может выглядеть так: 


у019 СМу\1ем: :Оп/рдате (С\У1ем» р5епдег, ПРАВАМ 1Н1пт, С06]есе» рН1пт) 
{ 
СМубоситеп* рМубдос = @бетбоситепт(); 
С$г1па 1аз{Мате = рМу0ос->бетга${Маме(); 
п_рматетат1с->5е{и1паомТех{ (1аз{Маме); // т_р№атезта{1с - переменная-член 
// СМу\Мтем 


Вспомогательная информация передается через вызов ОращеАЙТеи». Исход- 
ная реализация ОпОраше объявляет недействительным все окно представления. 
В переопределенной ее версии вы можете объявить недействительным прямо- 
угольник меньшего размера — в соответствии с информацией, полученной от 
ПрашеАШТеи»; (через последние два параметра). 

Если функция ИражшеАМТеи» класса СРоситет вызывается с параметром р5епаег, 
указывающим на конкретный объект «вид», ОпОраше вызывается для всех пред- 
ставлений документа, кроме указанного в параметре. 


Функция СИеи::ОптШаШраае 


Эта виртуальная функция класса СУ вызывается при запуске приложения, а также 
при выборе команд Ме\у или Ореп меню ЕПе. Версия Отийюраше в базовом 
классе СИеш просто вызывает ОпОраше. Переопределяя ее в своем производном 
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классе «вид», позаботьтесь, чтобы она вызывала ОпттаЮрае базового или ОпИр- 
аще производного класса. 

Функция ОтишаШраше производного класса пригодна для инициализации 
объекта «вид». При запуске программы каркас приложений вызывает ОптшаюЮраже 
сразу после вызова ОпСтеше (если вы задействовали ОпСтеше в своем производ- 
ном классе «вид»). ОпСтеше вызывается только раз, но ОппийаЮраже можно вы- 
зывать неоднократно. 


Функция СБоситепЕ:ОпМеибоситегт 


Эту виртуальную функцию каркас приложений вызывает после создания объекта 
«документ» или выбора в меню Ее $01-приложения команды Ме\’. Именно здесь 
удобнее всего инициализировать переменные-члены вашего класса «документ». Для 
производного класса документа МЕС АррИсаНоп УЛгага генерирует переопреде- 
ленную функцию ОиМешОоситети. Обязательно оставьте в ней вызов функции 
базового класса. 


Простейшее приложение в архитектуре 
«документ-вид» 


Допустим, вам не нужно несколько представлений документа, но необходима 
поддержка каркаса приложений для работы с файлами. Тогда забудьте о функци- 
ях ОрашеАШТеих и ОпИраеше и придерживайтесь следующей простой схемы. 

1. Взаголовочном файле производного класса документа (сгенерированном МЕС 
АррИсацоп УЛгага) объявите переменные-члены, в которых хранятся основ- 
ные данные программы. Объявите их открытыми или сделайте производный 
класс «вид» дружественным классу документа. 

2. В производном классе «вид» переопределите виртуальную функцию Ой й/- 
Ораше. Каркас приложений вызывает ее после инициализации или считыва- 
ния с диска данных документа. (О работе с дисковыми файлами см. главу 16.) 
ОпттижИражще должна обновить представление в соответствии с текущим со- 
держанием документа. 

3. Сделайте так, чтобы обработчики оконных и командных сообщений и функ- 
ция Оп)гаиш в производном классе «вид» имели прямой доступ к переменным- 
членам класса «документ», используя для этого функцию Сеоситети. 

В нашей упрощенной среде «документ-вид» события разворачиваются в таком 
порядке: 
Запуск программы Конструируется объект СМуроситети. 
Конструируется объект СМуИеш. 
Создается окно представления. 


Вызывается СМуеш::ОпСтеие (если она 
сопоставлена этому классу). 


Вызывается СМуроситеп:ОпМешоситени. 
Вызывается СИеш::ОтишаЮраае. 
Инициализируется объект «вид». 


Окно представления объявляется 
недействительным. 


Вызывается СМуйеи::ОпОташ. 
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Пользователь редактирует данные Функции класса СМуйеи обновляют 
переменные-члены СМубоситети. 


Завершение работы программы Уничтожается объект СМуе. 
Уничтожается объект СМуроситети. 


Класс СРогтУеи 


Этот весьма полезный класс обладает многими свойствами немодального диало- 
гового окна. Класс, производный от СЕоттИеи», как и от СО 08, связан с диало- 
говым ресурсом, определяющим параметры окна и список элементов управления. 
Класс СЕотт\еи поддерживает те же ООХ- и ОРУ-функции обмена и проверки 
данных, что и в использовавших СОйов программах из главы 7. 

‚Объект СЕоттИеи получает уведомляющие сообщения прямо от своих элемен- 
тов управления, а также принимает командные сообщения от каркаса приложе- 
ний. Очевидное отличие СРотиеи от СБйщов — способность первого обрабаты- 
вать команды каркаса приложений, что упрощает управление окном представле- 
ния из основного меню окна-рамки или через панель инструментов. 
анны 
Внимание! Если диалоговое окно для СЁо’иеи сгенерировано МЕС АррНсаНоп 

УЛ гага, его свойства задаются корректно, но, создавая его в редакторе 
диалоговых окон, обязательно задайте в диалоговом окне П1а10$ РгорегИез 
СВОЙСТВА: 

Ш тие = СЬИа (дочернее окно); 

Ш Вогаег = М№опе (без обрамления); 

Ш УзыЫе = флажок сброшен (изначально невидимо). 


Класс СЕоттИеи — производный от СУеи (точнее, от СстоИеи)), а не от СРВ. 
Так что не надейтесь на присутствие функций-членов СО 108. В нем нет вирту- 
альных функций ОйтйГмов, ОпОК и ОпСапсе!. Функции-члены класса СЕоттеи 
не вызывают Иражшереаа и ООХ-функции. Вы сами должны заботиться о вызовах 
Ирашереа (обычно в ответ на уведомления от элементов управления или на ко- 
мандные сообщения). 

Хотя СЕоттМеи происходит не от СБё/108, он построен на основе диалогово- 
го окна УЛпао\ $. Поэтому вы можете использовать многие функции-члены клас- 
са СОйов, например, Сою08СТ и МехИ8С. надо лишь привести тип указателя 
на СЕоттеи к указателю на Сов. Показанный ниже оператор, извлеченный 
из функции-члена некоего класса, производного от СРотиеи», устанавливает фокус 
на заданный элемент управления. Сей) юЙет — это функция класса С\па, поэто- 
му класс, производный от СЕоттИе», ее наследует. 


((С01а1090*) 111$)->60%0019С%г1 (бе+019Т{ет( ТОС_МАМЕ)); 


МЕС Арр|Исацоп У/Л2агА позволяет использовать СЕот"Ие в качестве базово- 
го для вашего класса «вид». В этом случае МЕС АррйсаНоп УЛгагА сгенерирует пустое 
диалоговое окно с корректным набором стилей. Далее в окне Ргорегие$ утилиты 


' Весьма опасное приведение типа, которое работает только потому, что воюр8ст 
использует из класса СОйщов лишь переменную-член т Ра. Эта переменная уна- 
следована из СУпа, поэтому она есть и в классе СЕоттИеш .— Прим. перев. 
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С!а5$ Меу/ создайте обработчики уведомляющих сообщений от элементов управ- 
ления, обработчики командных сообщений и сообщений обновления пользова- 
тельского интерфейса. (Подробнее об этом см. пример.) Кроме того, вы можете 
определить переменные-члены и критерии проверки. 


Класс СОШес 


На вершине иерархии МЕС-классов находится класс СОБуес. Большинство осталь- 
ных классов наследует корневому классу СОБесг. Класс, производный от СОБесь, 
наследует ряд важных характеристик. Многие преимущества этого станут очевидны 
при чтении следующих глав. 

В этой главе мы рассмотрим, как наследование от СОБуес! позволяет задейство- 
вать объекты в организации вывода диагностической информации, а также вклю- 
чать их в классы наборов (соЦесйоп с!а$$). 


Диагностика 


В МЕС-библиотеке есть ряд полезных средств дампа диагностической информа- 
ции. Эти средства активизируются, если выбрать конфигурацию сборки РеБие, в 
случае же выбора конфигурации Ке!еазе отображение диагностической информа- 
ции отключается, и диагностический код не компонуется с программой. Весь 
диагностический вывод направляется в окно ОириЕ отладчика. 
ен 
Совет Для очистки окна диагностического вывода поместите в него курсор, 
щелкните правой кнопкой и в контекстном меню выберите команду 


Сеаг АП. 
ОА ОЧЕН поатксыьощи мии: подайте пооцласкаый 


Макрос ТВАСЕ 


Вы уже встречали данный макрос в предыдущих примерах. Операторы ТКАСЕ 
активизируются, если определена константа _РЕВИС — это происходит в конфи- 
гурации РеБи$ и когда переменной а/ХхТгасеЕпаЫеа присвоено значение ТЮОЕ. 
Оператор ТКАСЕ работает аналогично функции рипу языка С, но полностью от- 
ключается в финальной (Вееазе) версии программы. Вот типичный пример: 


ТЕ пбоипЕ = 9; 
С51г1п9 э+гОезс(”то+а1”); 
ТВАСЕ(“Соип{ = %49, Оезсг1рТоп = %5\п", пСоипе, з1г0езс): 


Хотя макрос ТКАСЕ и не рекомендуется (в документации предлагается исполь- 
зовать макрос А7ЕТКАСЕ), он все еще доступен и прекрасно работает. 


Объект айхбитр 


Эта альтернатива ТКАСЕ более годится для языка С++. МЕС-объект ахритр при- 
нимает переменные из программы с использованием синтаксиса, аналогичного 
синтаксису объекта С++ потокового вывода сои. Применять сложные строки фор- 
матирования не требуется — формат вывода управляется переопределяемыми 
операторами. Вывод а/хРитр направляется туда же, куда и вывод ТКАСЕ, но объект 
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аб‹Битр определен только в отладочной версии МЕС-библиотеки. Вот типичный 
ориентированный на потоки диагностический оператор, который дает тот же 
результат, что и приведенный выше макрос ТКАСЕ: 


ТП пбоипЕ = 9; 
С31г119 з{гОезс(“{ота1”); 
#1Г4ег`_ОЕВИВ 
аРхбитр << “Соипф = " << пСоипе 
<<“, Оезсг1ре1от = " << з&г0езс << “\п” 
#епо1Р 


Хотя и в ахритр, и в со применяется одинаковый оператор вставки (<<), код 
их реализации различен. Объект соиё — часть библиотеки 1юзгеат У15иа| С++, а 
абхБитр — часть МЕС-библиотеки. Не думайте, что какие-то возможности фор- 
матирования, обеспечиваемые сор, доступны при работе с ахБитр. 

У классов, не производных от СОБ]ес, таких как СУ тв, СТипе и СКесь, есть свои 
переопределенные операторы вставки для объектов СритрСотшехи. Класс СБитр- 
Сотехр, экземпляром которого является ахБитр, содержит переопределенные 
операторы вставки для базовых типов С++ (#1, дон, срат* и т. д.). Кроме того, в 
нем есть переопределенные операторы для ссылок и указателей на СОБуесёЕ — они- 
то и представляют для нас интерес. 


Классы СБитрСощех{ и СОШес! 


Если оператор вставки класса СритрСошех{ принимает указатели и ссылки на 
СОБесь он должен также принимать указатели и ссылки на производные классы. 
Рассмотрим тривиальный класс САсйоп, производный от СОБуесё 


с1азз САс{10п : риуб11с СОБ]ес* 
{ 
руб11с: 
11 м_пТ1ме; 
№ 


Что же происходит при выполнении следующего оператора? 


нагаег _ОЕВУВ 
аРхбитр << асф10п; // асф1оп - объект класса САсф1оп 
#епат т 


А вот что. Вызывается виртуальная функция СОБес!::Ритр. Если вы не пере- 
определили ее для САсйоп, то многого от нее не получите — разве что адрес объекта. 
Переопределив же Ритр, можно получить сведения о внутреннем состоянии ин- 
тересующего нас объекта. Взглянем на функцию САсйоп::Ритр: 


нтгаег _ОЕВИб 

\0149 САсф1оп: :Витр(СВитрСоптех{& 4с) сопзе 

{ 
С061ес*: :битр(9с); // всегда вызывайте функцию базового класса 
с << "\пее = "<< мопТие << “\п"; 

} 

депа1Р 
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Функция Ритр базового класса (СОБлес/) выводит примерно такую строку: 
а С06]ест ат $411504 


Если в определении класса САсноп использован макрос РЕСГАЮЕ РУМАМГ, а в 
реализации — [МРГЕМЕМТ РУМАМГ, то при выводе диагностической информации 
вы получите имя данного класса: 


а САст1оп а $411504 
даже если оператор отладочного вывода выглядит так: 


#1Р4ег _ОЕВУб 
аРхбитр << (С0Б]ес+&) асЕ1оп: 
#епо1Р 


Вместе эти два макроса вставляют в ваш класс, производный от СОБесь, спе- 
циальный код библиотеки МЕС периода выполнения. При наличии такого кода 
программа в период выполнения может определить имя класса объекта (напри- 
мер, для отладочного дампа) и получить сведения об иерархии классов. 
папа 
Примечание Пары макросов (РЕСГАКЕ $ЕЮМАГ, МРЕЕМЕМТ_$ЕЮАГ,) и (РЕСГА- 

КЕ _РУМСКЕАТЕ, [МРЕЕМЕМТ РУМСКЕАТЕ) обеспечивают ту же поддержку 
периода выполнения, что и пара макросов (РЕСГАКЕ РУМАМГС, [МРИЕ- 


МЕМТ _РУМАМГС). 
м 


Автоматическая диагностика неуничтоженных объектов 


Если программа собирается в конфигурации ПеБир, после завершения програм- 
мы каркас приложений сообщает обо всех неуничтоженных объектах. Эта диагно- 
стика очень полезна; но все же аккуратно удаляйте все объекты — даже те, что обыч- 
но сами исчезают при завершении программы. Такая очистка — показатель хо- 
рошего стиля программирования. 

Код, добавляющий отладочную информацию в выделенные блоки памяти, те- 
перь находится не в МЕС-библиотеке, а в отладочной версии С-библиотеки пе- 
риода выполнения (СКТ). Если вы решите загружать МЕС динамически, то вместе 
с РЫ-модулями МЕС-библиотеки будет загружаться и МЗУСВТР.ОТА,. Если вы до- 
бавите в начало СРР-файла строку: 


#9е71пе пем БЕВУб_МЕМ 


СЕТ-библиотека покажет имя файла и номер строки, в которой был распределен 
данный блок памяти. Эту строку МЕС АррИсаНоп УЙгагА вставляет в начало всех 
сгенерированных им СРР-файлов. 


исел? Нет ничего проще __ 
га управления. Однако если нуж- | 
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Пример Ех15а: простое взаимодействие 
между документом и представлением 


Первый из двух примеров этой главы (рис. 15-1) иллюстрирует простейший слу- 
чай взаимодействия «документ-вид». У класса документа СЁЕх15аос, производно- 
го от СРоситеть, есть единственный внедренный объект С5{идети, который пред- 
ставляет одну запись о студенте, состоящую из имени (С517718) и целочисленного 
балла. Класс «вид» СЕх15 а еи», производный от СЁРоттИеи,, отображает на экране 
запись о студенте и содержит поля ввода имени и балла. Кнопка по умолчанию 
Егцег обновляет данные документа согласно содержимому полей ввода. 
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уЕх15а - ЧаННей 


Рис. 15-1. Программа Ех15а в действии 


Код класса СУшает приведен в листинге. Большинство возможностей данно- 
го класса предназначено для программы Ех15а, но некоторые из них пригодятся 
как в Ех15Ь, так и в программах-примерах главы 16. А пока обратите внимание 
на переменные-члены, конструктор по умолчанию и на объявление функции Ритр. 
Макросы РЕСГАКЕ РУМАМГС и [МРЕЕМЕМТ РУМАМГС обеспечивают вывод для класса. 


см. след. стр. 
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создаем программу Ех15а. 


) 


Итак 
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1. Используя МЕС АррИсайоп У\У/12таг4, создайте проект Ех15а. На странице 
АррИсайоп Туре мастера установите переключатель в положение Зтае аоситепи, 
а на странице бепега{еа С1а$3е$ в качестве базового выберите класс СРоттИеи»: 


МЕС дройсаНой Уйраеа - 15а 


бепега{ед С1а5$е5 
Ве\мем депегабе4 с1ас5ез ап4 зресЁу Базе Чаззез Гог уоцг аррйсаноп. 


2. Используя редактор меню, замените команды в меню Е4И. Удалите пре- 
жнее содержимое меню ЕА и вставьте команду Сеаг АП. Используйте константу 
по умолчанию Л) ВМТ СГЕАКАШ, назначенную каркасом приложений. 

3. В редакторе диалоговых окон измените диалоговое окно ШО _ЕХ15А_ 
ЕОКМ. Открыв диалоговый ресурс /2)_ЕХ15А_ЕОКМ, сгенерированный масте- 
ром МЕС АррИсайоп \У/Лгага, добавьте элементы управления: 


Убедитесь, что свойства в окне Ргорегиез заданы так: 5ге = СВИа, Вог4ег = Мопе 
и УЗЫе = Еае. Присвойте элементам управления идентификаторы: 


Элемент управления Идентификатор 
Поле ввода Мате ШРС_МАМЕ 
Поле ввода Огаае ШРС_сКАРЕ 


Кнопка Ецег 1РС_ЕМТЕК 
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4. Вокне Ргорегие$ утилиты (125$ У4еуу добавьте обработчики сообщений 
класса СЕх15а Ме. Выберите класс СЕх15 аеи в окне С!а5$ У\1е\ и добавьте 
следующие обработчики сообщений. Оставьте имена функций по умолчанию. 


Идентификатор объекта Сообщение Имя функции-члена 
ШР2С_ЕМТЕК ВМ СИСКЕР ОпвВисИсведЕ тет 
12_ЕБГГ_СЁЕАКАИ, СОММАМО опЕайеатай 
12_ЕБТ_СГВАКАИ, ОРРАТЕ_СОММАМО (Л опИрашеЕайСеатай 


5. В окне РгорегИе$ утилиты С1а$5 У1еу добавьте переменные для СЕх15а- 
ИЙеи. В окне С1!а55 У1е\у щелкните правой кнопкой класс СЕх15аЙеи и в кон- 
текстном меню выберите Ааа УапаЫе. Добавьте переменные: 
Иная 


Элемент управления Имя переменной _ Категория Тип переменной 
ШР2С_СКАРЕ т_пбстаае Ищие И 
12С_МАМЕ т_5йМате Ишие сбттв 


Задайте для тт_пистаае минимальное значение 0, максимальное — 100. За- 
метьте, что АЧ4 Метрег УанаЫе УЙ1гага генерирует код проверки данных, вво- 
димых пользователем. 


6. Добавьте прототип вспомогательной функции ОражеСотто!5Еготрос. 
В окне С!а55 У1еу’ щелкните правой кнопкой класс СЕх15аеи; и в контекст- 
ном меню выберите команду Ааа РипсНоп. Заполните диалоговую форму, что- 
бы добавить функцию: 


рг1 мате: 
\019 ИрдатеСопЕго1$РготОос(): 


7. Отредактируйте файл Ех15а\У1еуу.срр. МЕС АррИсаноп \/хагА создал заго- 
товку функции ОшитаЮрае, а АЧЧ Мегабег ЕипсНоп УЛтага — функции Праше- 
СоттоВЕтотрВос. Последняя представляет собой закрытую вспомогательную 
(Берег) функцию-член, которая переносит данные из документа в перемен- 
ные-члены СЁЕх15аеи), а затем в элементы управления диалогового окна. От- 
редактируйте код так: 


\0149 СЕХ15а\1ем: : ОпТп1{1а10рдате() 

{ // вызывается при запуске 
СРогт\1ем: : ОпТп1{1а10рдате(); 
ОрдатеСоп+го13Еготбос(); 

} 

\01а СЕх15а\/1ем: : УрдафеСопго1$Еготбос (\014) 

{ // вызывается из ОпТп11а10рдате и 0пЕд1+С1еага11 
СЕх15адос* рбос = бефбоситеп*(); 
т_п@гаде = рбос->т_з+и4деп{. т_пбгаае; 
т_${гМаме = рбос->м_зфидепе. п_згМаме; 
Ордатедата(РАЕЗЕ); // вызов 00Х 


ОпВпСйсведЕтег заменяет функцию ОПОК, которую можно было бы ожи- 
дать в классе диалогового окна. Она передает данные из полей ввода в пере- 
менные-члены объекта «вид», а потом в документ. Добавьте выделенный код: 
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\014 СЕх15а\1ем: :ОпВпС11скедЕптег() 

{ 
СЕх15абос» р0ос = бе{боситепт(); 
Ордафедата(ТВИЕ); 
рдос->т_зТтидепт.т_пбгаде = т_пбгааде; 
рбос->т_зфидеп{.м_зЕгМате = м_зфгМаме; 


В сложной программе с несколькими представлениями данных команда С!еаг 
АН передавалась бы прямо документу. В нашем же простом примере она доста- 
вляется объекту «вид». Обработчик сообщения обновления пользовательского 
интерфейса отключает элемент меню, если объект С5идет! в документе уже 
пуст. Введите выделенный код: 


№\01а СЕх15а\мтем: :ОпЕд1{С1еага11() 

{ 
бе{боситеп{()->т_зфи4депЕ = С5и4деп{(); // “пустой” объект 
ОрдатеСопго13Рготдос(); 


} 
\019 СЕх15а\1ем: :Оп/рдафеЕ91{С1еага11 (ССма/Т» рСмдит) 
{ 
рСтаит->Епаб1е ( бе{боситеп{()->т_зфидепЕ != СЗ+идепте()); 
// пустой? 


} 


8. Добавьте в проект Ех15а файлы класса СЗиаетт. Скопируйте файлы 5- 
Чепе.В и 5иаепе.срр с компакт-диска. В У151а1 С++ .МЕТ из меню Рго]еси выбе- 
рите команду АЧа Ех!15Ипз Цет и в списке файлов — ЗаАепе.В и $Чепе.срр. 
Щелкните ОК. У!5ца1 С++ МЕТ добавит имена этих файлов в проект, так что при 
сборке проекта они будут автоматически скомпилированы. 

9. Добавьте переменную типа С$и4етё в класс СЕх15а)ос. Это можно сде- 
лать, используя С!а$зУ1еу,, тогда директива #тсшиае будет добавлена автомати- 
чески. 


риуб11с: 
С5тидепе тм_зфидепе; 


Конструктор класса СУидет вызывается при создании объекта «документ», 
а деструктор вызывается автоматически при уничтожении документа. 
10. Отредактируйте файл Ех15а)ос.срр. Для инициализации объекта Сшает 
используйте конструктор СЁх15арос: 


СЕх15абос: :СЕх15а0ос() : м_зфидеп{("4егаи1* уа1ие”, 0) 
{ 

ТВАСЕ( "Боситепе об]есф сопзЕгистед\п”); 
} 


Мы не определим, правильно ли работает Ех15а, пока не отобразим содер- 
жимое документа по ее завершении. Для этого применим деструктор, который 
вызовет функцию Ритр документа, а та — функцию СбЗшаепЕ:Ритр. 
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СЕх15а0ос: : "СЕх15абос( ) 

{ 

#174ег _ОЕВИб 
Битр(ахбитр); 

#еп91{Р // _ОЕВУВ 

} 


\014 СЕх15адос: :Витр(СбитрСоптехе& 9с) сопз+ 
{ 

Сбоситеп* : :битр(ас); 

дс << "\п” << п_зфидепЕ << "\п"; 
} 


11. Соберите и протестируйте приложение Ех15а. Введите какое-нибудь имя 
и балл, а затем щелкните Егиег. Закройте приложение. Появились ли в окне Ребие 
сообщения, аналогичные показанным ниже? 


а СЕх15абос а+ $411580 
М_$г11{1е = 1п111{1е9 
м_$тгРатиМаме = 
т_6М09171е4 = 0 
т_рО0осТетр1ате = $4113А0 


а СЭтидепЕ а{ $411504 
м_${гМаме = $и111уап, Ма1%ег 
т_пбгаде = 78 


Примечание Чтобы увидеть эти сообщения, скомпилируйте программу в от- 
ладочной конфигурации (РеБиз) и запустите ее под управлением от- 
ладчика. 


Усложненное взаимодействие 
документа и представления 


В программе, поддерживающей множественное представление данных, взаимо- 
действие «документ-вид» сложнее, чем в Ех15а. Основная проблема в том, что 
пользователь редактирует данные в одном окне представления, а остальные окна 
представления надо обновлять, чтобы отразить внесенные изменения. Здесь по- 
надобятся функции ОрашеАИеш$ и ОпОраше, поскольку документ будет высту- 
пать в качестве координирующего центра при обновлении окон представления. 
При разработке придерживайтесь следующей схемы. 


1. В созданном МЕС АррИсаНоп УЛтагА заголовочном файле производного клас- 
са документа объявите переменные-члены документа. Их можно сделать закры- 
тыми, а затем определить функции-члены для доступа к ним или объявить класс 
«вид» дружественным классу «документ». 

2. В производном классе «вид» через окно Ргорегие$ утилиты С!а$5 Улеу’, переопре- 
делите виртуальную функцию-член ОпОраже. Каркас приложений вызывает ее 
при любом изменении данных в документе. ОпОраше должна изменять объект 
«вид» в соответствии с текущим содержанием документа. 
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5. Проанализируйте командные сообщения. Для каждого определите, к чему оно 


относится: к документу или к его представлению. (Пример команды, относя- 
щейся к документу, — Сеаг АП в меню Еай.) Теперь сопоставьте команды соот- 
ветствующим классам. 

Предусмотрите обновление данных в документе соответствующими функци- 
ями-обработчиками командных сообщений в производном классе «вид». По- 
заботьтесь, чтобы все они перед завершением обращались к СРоситет::Ораа- 
г АИ еих. Для доступа к документу применяйте версию функции-члена СИеи::Се1- 
Доситет, обеспечивающую безопасное приведение типов. 
Запрограммируйте обновление данных документа соответствующими функци- 
ями-обработчиками командных сообщений в производном классе документа. 
Все они перед завершением тоже должны вызывать Сроситет::ОражщеАЩТеи». 


Последовательность событий для сложного взаимодействия «документ-вид» такова. 


Запускается приложение Создается объект СМубоситети. 
Создается объект СМуе1. 
Создаются другие объекты «вид». 
Создаются окна представлений. 


Вызывается СМуЙеиш::ОпСтеше 
(если она сопоставлена). 


Вызывается СРоситетш::ОпМешРоситет. 

Вызывается СУеи::ОтишеЮраае. 
Вызывается СМу\еи::ОпОрае. 
Инициализируется объект «вид». 


Пользователь выбирает команду, Функции класса СМу\еш обновляют 
относящуюся к представлению данных переменные-члены класса СМуроситети. 


Вызывается функция 
СРоситепт:ПражщеАШТеи». 


Вызывается функция ОпОраше 
для других объектов «вид». 


Пользователь выбирает команду, Функции СМуроситет! обновляют 
относящуюся к документу переменные-члены. 


Вызывается функция 
СРоситет:ОражщеАШТеи». 


Вызывается функция 
СМу\е\м:ОпОрааге. 


Вызываются функции ОпОраше 
для других объектов «вид». 


Пользователь завершает приложение Уничтожаются объекты «вид». 
Уничтожается объект СМубоситети. 


Функция СВоситепЕ:БеееСотет$ 


Иногда нужна функция, способная удалить содержимое документа. Вы могли бы 
написать свою закрытую функцию-член, но каркас приложений уже определил 
для этого виртуальную функцию РеаеСотетй в классе СБоситет. Каркас при- 
ложений вызывает вашу переопределенную функцию РеееСотшет при закрытии 
документа и, как вы увидите в главе 16, в ряде других случаев. 
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Класс набора СОБ 


Познакомившись с классами наборов, вы наверняка удивитесь, как до сих пор без 
них обходились. Один из представителей этого семейства — СОШ Освоив его, 
вы легко разберетесь в классах списков (151 15$), массивов (аггау с1а$5) и слова- 
рей (тар с1а$$). 

Может показаться, что наборы — это что-то новое, но в языке С всегда под- 
держивалась одна из их разновидностей — массивы. Размер массивов в языке С 
фиксирован, они не поддерживают вставку новых элементов. Программисты на 
С писали библиотеки функций для других наборов, включая связанные списки 
(Пакеа 11515), динамические массивы (Чупапус аггау) и индексируемые словари 
(шпаехеа @сНопагу). В языке С++ есть очевидная и более удачная (в сравнении с 
библиотекой С-функций) альтернатива по реализации наборов — это классы. 
Например, объект-список корректно инкапсулирует внутренние структуры дан- 
ных списка, 

Класс СОБ“ поддерживает упорядоченные списки указателей на объекты 
классов, производных от СОБест. Другой МЕС-класс наборов, СР, вместо ука- 
зателей на СОБуес! хранит указатели ога. Почему бы не задействовать его вместо 
СОЫ45Р Класс СОБ имеет ряд преимуществ и при выводе диагностической 
информации, и при сериализации (зепаНтаНоп) (см. главу 16). Одно из важных 
свойств СОР/451 — способность хранить смешанные Указатели (пихеа роииегэ). 
Иначе говоря, набор СО 15! может одновременно содержать указатели как на 
объекты Сиде, так и на объекты С7ёасвет, при условии что оба класса наследу- 
ют СОБуес+. 


Применение класса СОБ 15 для создания списков типа Е!ЕО 


Один из простейших примеров применения объекта СОБ! — добавление новых 
элементов в конец и удаление элементов из начала списка. Элемент, первым вне- 
сенный в список, первым и извлекается из него [принцип ЕГЕО (ЕшзЕ п, Ее Оцб — 
«первым вошел, первым вышел»]. Допустим, элементы списка — объекты создан- 
ного вами класса САсйоп, производного от СОБес. Следующая программа рабо- 
тает в режиме командной строки и заносит в список 5 элементов, а затем извле- 
кает их в том же порядке. 


#1ис1иде <атх. п> 
Напс1иде <аРхсо11. > 


С1а$з САст1оп : риб11с СОБдес+ 

{ 

рг1уате: 
11 м пТе;: 

риб11с: 
САс1оп(1п{ пТ1те) { м_пТтаме = пТаме; } // конструктор запоминает 

// целочисленные показания времени 

у019 Ри1пеТ1те() { ТВАСЕ(“41те = %а\п”, тп те): } 

}; 

ТП та1п() 

{ 
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— ыы — 


САсф1оп* рАСТ10п; 
С0611$+ ас+10пЕ1$1; // список САс{10п создается на стеке 
а: 
// вставляем объекты САст10п в порядке от 0 до 4 
ое баны 
рАСЕ1оп = пем САст1оп(1); 
ас{1 01131. А99Та11 (рАст10п); // приведение типа для рАсф1оп не требуется 


// извлекаем и удаляем объекты САсЕ1оп в порядке от 0 до 4 
мИ11е (!ас1опЕ1 т. Т$Етрфу()) { 
рАСЕ1оп = // для возвращаемого значения 
(САст1оп*) асф1опЕ1$т. ВетомеНеаа(); //. необходимо ‘приведение типа 
рАсф10п->Рг1пТ1 те (); 


де1ете рАст1оп; 


гефигп 0; 


В программе сначала создается объект асйопт4& класса СОБГ49. Затем функция- 
член СОМ5Е:АЯАТай добавляет в конец списка указатели на вновь создаваемые 
объекты рАсйоп. Преобразовывать тип для рАсйоп не нужно, так как параметром 
АааТай служит указатель на СОБесь а рАсйоп — указатель на производный от него 
класс. 

Далее указатели на объекты САсйоп извлекаются из начала списка, и объекты 
удаляются. В данном случае для возвращаемого значения КетогеНеаа требуется 
приведение типа, поскольку эта функция возвращает указатель на класс СОБесь, 
расположенный в иерархии классов выше класса САсйоп. 

Когда вы извлекаете указатель на объект из набора, сам объект автоматически 
не уничтожается. Удалять объекты САсйоп нужно оператором @еее. 


Перебор элементов СОБЫ${: переменная типа РО$ТИОМ 


Допустим, вам надо «пройти» все элементы списка. Класс СОБ 15! предусматрива- 
ет функцию-член Сей\еху, которая возвращает указатель на «следующий» элемент 
списка, но способ ее применения несколько необычен. СеШУех! принимает цело- 
численный параметр типа РО$/11ОМ, который представляет собой 32-разрядную 
переменную. Она содержит внутреннее представление положения в списке извле- 
каемого элемента. Так как РО$Г1ОМ передается по ссылке (&), функция может 
изменить его значение. 
аеШехё 


1. возвращает указатель на «текущий» элемент списка, который определяется 
передаваемым ей значением РОЗГГОМ; 


2. изменяет значение параметра РО$/Т1ОМ так, чтобы он соответствовал положе- 
нию следующего элемента списка. 


Так выглядит цикл с Сей\Уеж для списка из предыдущего примера. 
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САсф10п* рАсЕ1оп: 
РОЗТТТОМ роз = асЁ1опЕ1 31. бетНеааРоз1110п(): 
мп11е (роз != МЕ) { 
рАсффоп = (САс10п») асфтопЕ1 т. бетМехЕ(роз); 
рАсЕ10п->Рг1пТ1ме( ); 


Теперь допустим, что у вас есть интерактивное УЛпао\5-приложение, в кото- 
ром для перемещения вперед и назад по элементам списка служат кнопки панели 
инструментов. Для выбора очередного элемента Сей\ехе не годится, так как она 
всегда «увеличивает» значение переменной РОЗГГОМ, а предугадать, следующий 
или предыдущий элемент потребуется пользователю, просто невозможно. Взгля- 
ните на пример обработчика командного сообщения в классе «вид», который 
выбирает следующий элемент списка. Здесь т_асиот$ — объект типа СОШ 
внедренный в класс СМуИе1», а т_розйюп — переменная-член типа РОЗГГЮОМ, хра- 
нящая положение текущего элемента списка. 


СМУ\1ем: : ОпСоттапа№ех* () 


{ 
РОЗТТТОМ роз; 
САСЕ1оп»* рАСЕоп: 


11 ((ро$ = м_роз11оп) != МЕ) { 
т_асе1опЕт $1. бетмех{ (роз) 

11 (роз |= МА) { // роз равно МИЁЁ в конце списка 
рАс{1оп = (САсф1опх) асф1опЕ1 1. бетАЕ(роз); 
рАс10п->Рг1пТ1те(); 
т_ро$110п = роз; 

} 

е1зе { 

АгхМеззадеВох(“Епа от 11$ геаснед”): 


Чтобы увеличить переменную положения, вызывают СеШУем, а чтобы получить 
элемент — функцию СОМ. 1::СеЁ Е. Переменная т_розйют обновляется, только если 
не достигнут конец списка. 


Класс-шаблон набора СТуреаР!. 11 


Класс СОМ 4$ отлично работает, когда нужен набор, содержащий смешанные ука- 
затели. Однако если требуется набор с безопасным приведением типов, содержа- 
щий указатели только на один тип объектов, используйте классы-шаблоны набо- 
ров указателей из МЕС-библиотеки. Пример такого класса — СТуреаРи!1181. Шаб- 
лоны (1етр!а{е5) — относительно новый элемент С++, появившийся в М!сгозой 
У1виа! С++ 2.0. СТуреаРИ145! — это класс-шаблон, который применяется для созда- 
ния списка указателей на объекты любого заданного класса. Не вдаваясь в под- 
робности, скажем, что шаблон применяют для создания нового класса списка, 
производного от СРИ/115 или СОШ15. 
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Объект для указателей на САсйоп объявляется так: 
СТуредРг1$1< СО05Е1$+, САсф10п» > т_асф10пЕ1$%; 


Первый параметр — это базовый класс набора, второй — тип параметров и 
возвращаемых значений. В качестве базовых допускаются только классы СРИ!145 
и СОЫ15 так как других классов наборов указателей в библиотеке МЕС нет. Если 
вы храните объекты классов, производных от СОБесь, используйте как базовый 
класс СОШ в противном случае — СРИ14$. 

При описанном выше использовании шаблона компилятор гарантирует, что 
все функции-члены списка возвращают указатель САсйоп. Таким образом, можно 
писать: 


рАст1оп = м_ас{10пЕ1$1. бетА{(роз); // приведение типа не требуется 


Чтобы слегка упростить запись, прибегнем ёуреде/ и сгенерируем подобие са- 
мостоятельного класса: 


Туредег СТуредРЕгЕ1$1<С061$1, САсф10п»> САст10пЕ151; 
и тогда 7т_асйо 1$ можно объявить так: 


САст10пЕ1$ п_асф10пЕ1$1; 


Диагностика и классы наборов 


Функция Ритр для СОМА и других классов наборов обладает весьма полезным 
свойством. Вызвав Ритр для какого-либо объекта-набора, вы получите сведения 
обо всех объектах набора. Если в классах объектов, составляющих набор, приме- 
нены макросы РЕСГАКЕ ДУМАМГС и [МРЕЕМЕМТ_РУМАМГ, в информации появит- 
ся имя класса всех объектов. 

По умолчанию функции Ритр для наборов выводят только имена классов и 
адреса объектов в наборе. Чтобы функции Ритр для наборов вызывали функцию 
Ритр для каждого элемента набора, где-то в начале программы надо сделать вызов: 


#1Г49ег _ОЕВУВ 
аРхВитр. Зе{бертн(1); 
депа1Р 


Тогда оператор: 


+1гаеЕг _ОЕВУб 
аРхбитр << аст10пЕ1$1; 
депате 


будет выводить информацию примерно так: 


а СОБ13{ а{ $411832 
м11И 4 е1етепт$ 
а САсЕ1оп а{ $412606 


{1те = 0 
а САсе1оп ат $412632 
{1те = 1 


а САсф1оп а{ $41268Е 
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{1те = 2 
а САст1оп а $4126ЕА 
1те = 3 


Если набор содержит смешанные указатели, для класса объекта вызывается 
виртуальная функция Ритр, и выводится имя соответствующего класса. 


Пример Ех15Ь: $0!-приложение 
с множественными представлениями 


Этот пример расширяет программу Ех15а. Вот перечень основных отличий. 


Ш Документ содержит не один, а список объектов СЯиаети. (Теперь вы понимае- 
те, почему мы создали класс С51и4ет вместо того, чтобы сделать 7и_ Мате и 
т_патаае переменными-членами класса «документ».) 

Ш Кнопки на панели инструментов позволяют перемещаться по списку. 

Ш Структура программы допускает создание дополнительных представлений 
данных. Команда Сеаг АП теперь передается объекту «документ», и поэтому в 
игру вступают функции ПрашеАТИеи для документа и Оп0раше для его пред- 
ставления. 

Ш Особый код для представления информации о студентах изолирован, чтобы 
класс СЕх156Иеш можно было впоследствии трансформировать в базовый, 
содержащий только универсальный код. Производные классы могут переоп- 
ределять отдельные функции для работы со списками объектов, характерны- 
ми для конкретного приложения. 


Окно программы Ех15Ь (рис. 15-2) отличается от окна программы Ех15а 
(рис. 15-1). Кнопки активны, только когда это допустимо. Например, в конце списка 
становится неактивной кнопка Мех! со стрелкой вниз. 

На панели инструментов расположены кнопки: 


Кнопка Назначение 

Перейти на первую запись 
Перейти на последнюю запись 
Перейти на предыдущую запись 
Перейти на следующую запись 


Удалить текущую запись 


ОХх+> ЮУ 


Вставить новую запись 


Кнопка СШеаг в окне представления очищает поля ввода Мате и Сгаае. Коман- 
да Цеаг АП в меню ЕаИ удаляет из списка все записи и очищает поля ввода в окне 
представления. 

На этот раз мы не станем давать пошаговые инструкции. Поскольку объем кода 
увеличился, просто приведем листинг отдельных частей и требования к ресурсам. 
Дополнительные фрагменты кода и те места, где надо внести изменения в код, 
сгенерированный МЕС АррИсаНоп \ЛтагА и мастерами, доступными из окна С!а$$ 
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\Уе\, выделены. Операторы ТКАСЕЁ позволят наблюдать за ходом выполнения про- 
граммы в окне отладки. 


Ен15Ь - ЦпЫЧед 


Апдегзоп, ВоБ 


Рис. 15-2. Программа Ех156 в действии 


Требования к ресурсам 


В данном разделе описаны заданные в файле Ех15Ъ.гс ресурсы. 


Панель инструментов 


Чтобы создать панель инструментов (рис. 15-2), нужно удалить кнопки Еай Си, 
Сору и Разе (четвертую, пятую и шестую слева) и заменить их шестью новыми. 
Для создания некоторых кнопок применяется команда Е1р УегИса| из меню Ипаве, 
ав файле Ех1 5Ъ.гс определяется связь между идентификаторами команд и кноп- 
ками панели инструментов. 


Меню З{идет: 


Присутствие в меню пунктов, соответствующих новым кнопкам панели инстру- 
ментов, вообще-то необязательно. (Окно Ргорегие$ средства С!а$$ У1е\у позволяет 
создавать обработчики команд панели инструментов так же просто, как и коман- 
ды меню.) Но большинство УЛп4оу/з-приложений позволяет вызывать все команды 
через меню, поэтому лучше не обманывать ожиданий пользователей. 


Меню ЕЧИ 

В меню ЕЧй операции с буфером обмена заменены пунктом Сеаг АП (см. п. 2 
примера Ех15а). 

Диалоговый шаблон /00_ЕХ15В_РОВМ 


Диалоговый шаблон ШР_ЕХ15В_ЕОКМ, приведенный здесь, напоминает шаблон 


из примера Ех15а (рис. 15-1) за исключением того, что кнопку Егиег заменила 
кнопка Сеаг. 
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Вот идентификаторы элементов управления: 


Элемент управления Идентификатор 
Поле ввода Мате ШС_МАМЕ 

Поле ввода Сга4е РС_СКАРЕ 
Кнопка Сеаг РС_СГЕАК 


Е а 
Стили элементов управления — такие же, как иу их аналогов из примера Ех15а. 


Требования к коду 


Файлы и классы в проекте Ех15Ъ. 


Ааа 


Заголовочный Файл 
файл исходного кода Классы Описание 


Ех15Б.В Ех15Ь.срр СЕх15БАрр Класс приложения 
(создан МЕС АррИсайоп \Йхага) 


САБОИИ Ув Диалоговое окно АБоиЕ 


МашЕгт.В МашЕгт.срр СМатЕтате Основное окно-рамка 
$О1-приложения 

Ех15БРос.В Ех15Б)ос.срр Ех156Оос Документ приложения 

Ех15 Б.В Ех15Ь.срр Ех15Бтеш Класс «вид» — форма, представляю- 


щая информацию о студенте 
(производный от СЕотиШеи») 


Зааепев 5шаепесрр Сушает Запись о студенте (как и в Ех15а) 


(ЧАЁХ.В 5{ЧАЁх.срр Включает стандартные, предвари- 
тельно откомпилированные 


заголовочные файлы 
Ее Е аа поле ра арене ааа в ачевы ааа 


СЕх15БАрр 

Файлы Ех15Ъ.срр и Ех15Ъ.В — стандартные, сгенерированные МЕС АррИсаНоп 
УЛлага. 

СМатЕгате 

Код этого класса в файле МашЕгт.срр — также стандартный резульгат работы МЕС 
АррНсаНоп УЛрхага. 

СЗшиает 


Код тот же, что и в Ех15а, только в конец 5Аепе.Н добавлена строка: 


ТуредеГг СТуреарг1$1< СОБЕ$Е, СЗфидепе» > СЭтидепЕЕт$т; 


И 
Примечание Классы шаблонов наборов МЕС требуют наличия в ${ААЁХ.В опе- 


ратора: 
#1пс1и4е <афхтетр1. > 
бе, 
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СЕх1560ос 


Класс СЗидетЮос сначала сгенерирован МЕС АррИсайоп У/1гага. А вот код про- 
граммы-примера Ех15Ъ: 


12—2064 
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см. след. стр. 
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—___ 


_мо19 СЕх1560ос: : Опр 
_  рбпдит->ЕпаБте(!п_зтидепт 


Обработчики сообщений в СЕх156Бос 


Команду СШеаг АП (меню ЕЯ) обрабатывает класс документа. В окне Ргорегиез 
утилиты С1!а55 У1еу/ добавлены обработчики сообщений: 


ния 
Идентификатор объекта Сообщение Имя функции-члена 
ШР_ЕБРГГ СГЕАК АМ, ОМ СОММАМЬ ОпЕайСеатай 

ШР_ЕМТ. СЕАЮ АМ, ОМ ОРРАТЕ_СОММАМО_ ОпПрашевайСеатай 


Переменные-члены 


Класс документа содержит внедренный объект СидепИл! — переменную-член 
т_зиаепИлЯ, хранящую указатели на объекты Сиде. Объект-список констру- 
ируется при создании объекта С5идетос и уничтожается при закрытии програм- 
мы, СУи4епИ4 определен с помощью гуреде/ как С 'ГуреаРИ!1$1 для указателей на 
СЗшаейЕ. 


Конструктор 


Конструктор документа устанавливает глубину диагностического вывода, доста- 
точную для вывода информации по отдельным элементам. 


дешя 


Подставляемая в строку функция Сей. помогает изолировать представление от 
документа. Класс документа зависит от типа объектов в списке, в данном случае — 
от объектов класса Сбиает. Однако базовый класс «вид», чтобы получить указа- 
тель на список, не зная имени его объекта, может вызвать соответствующую фун- 
кцию-член. 


БеееСотет5 


равеСотет!5 — переопределенная виртуальная функция, вызываемая другими 
функциями класса «документ» и каркасом приложений. Ее задача — извлекать из 
списка указатели на объекты С5{идей! и удалять эти объекты. Важно ПОМНИТЬ, ЧТО 
объекты-документы 501 повторно используются после закрытия. ДеееСотептв 
попутно выводит сведения о списке студентов. 


Витр 


МЕС АррИсаНоп У/тагА генерирует заготовку этой функции между строками #й4е/ 
_РЕВОС и #еп), Поскольку глубина диагностического вывода для абхБитр уста- 
новлена в конструкторе документа равной 1, выводятся присутствующие в спис- 
ке объекты СЗидети. 
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СЕх1565\Ме\м 
Код класса СЕх156еи показан в листинге. 


см. след. стр. 
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Обработчики сообщений класса СЕх156 Ме 


В окне Ргорегие$ утилиты С!а$$ \Уе\м в классе СЕх1 56 Иеш создан обработчик уве- 
домляющего сообщения от командной кнопки Сеаг. 
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Идентификатор объекта Сообщение Имя функции-члена 
ШРС_СГЕАК ВМ СИСКЕБ ОпВисйскеа(еаг 


Так как класс СЕх156\еи» произведен от СЕоттИеш, С!а$$ Уле\ поддерживает 
определение переменных-членов диалогового окна. Следующие переменные до- 
бавлены мастером Ааа МетьЬег УанаЫе У/гага. 


яя ии ананааиннаныя 


Идентификатор Имя 

элемента управления переменной Категория Тип переменной 
Ш)РС_СКАБЕ т постаае Ижие пи 

Ш)С_МАМЕ т зт\Уате Уаше суттв 


—— 


Присвойте 7и_пСта4е минимальное значение 0, максимальное — 100. Устано: 
вите предельную длину т_ МУ ате в 20 символов. 

В окне Ргорегиез утилиты С!а5з У!е\и сопоставляются обработчики командам 
кнопок. Ниже приведена таблица команд и их обработчиков. 


Идентификатор 

элемента управления Сообщение Функция-обработчик 
Ш)_5$ТОРЕМТ НОМЕ СОММАМО ОпушаетНоте 
Ш_5ТОРЕМТ ЕМО СОММАМО ОпушаешЕпа 
Ш2_5ТОРЕМТ РКЕИОЦЙ$ СОММАМО ОпзшаетРгелои$ 
Ш_5ТОРЕМТ МЕХТ СОММАМО Опбшает Меж 
ШР2_5ТОРЕМТ №5ЕЮТ СОММАМО Оп$шаепИизет 
2_5ТОРЕМТ ДЕГЕТЕ СОММАМО Опзшаепреме 


——— А 


В каждый обработчик встроен контроль ошибок. 

Следующие обработчики сообщений обновления пользовательского интерфей- 
са вызываются или в момент простоя — для обновления состояния кнопок пане- 
ли инструментов, или при вызове меню 5ш4еп( — для обновления пунктов меню. 


Идентификатор 

элемента управления Сообщение Функция-обработчик 
1Ш2_5ТОРЕМТ НОМЕ ОРРАТЕ_СОММАМЬ_ 1 ОпОраше$шаетНоте 
ШР_5ТОРЕМТ ЕМБ ОРРАТЕ_СОММАМО_1 ОпОрашешаетЕпа 
2_5ТОРЕМТ _РКЕУОП$ ОРРАТЕ_СОММАМО Л опИрашешаетРгелои$ 
Ш2_5ТОРЕМТ МЕХТ ОРРАТЕ_СОММАМО_(Л опИраше$шаепиУех+ 
Ш2_5ТОРЕМТ РЕГЕТЕ ОРБАТЕ_СОММАМО_{Л ОпПращеСоттапаревее 


Например, кнопка выбора первой записи: 


м 


отключена, если список пуст, а также если переменная 7и_розйюп уже указывает 
на первую запись. Кнопка Ргеу1оиз (предыдущий) отключается в тех же случаях, 
поэтому она использует тот же обработчик команды обновления пользователь- 
ского интерфейса. Поэтому же применяют один обработчик кнопки Епа (конец) 
и Мехе (следующий). Так как вызов функций обновления командного интерфей- 
са иногда происходит с задержкой, обработчики командных сообщений должны 
содержать проверку ошибок. 
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Переменные-члены 


Переменная т_розйюп — что-то вроде курсора для набора объектов в документе. 
Он ссылается на отображаемый в данный момент объект СЯшает. Переменная 
т_р[15+ обеспечивает быстрый доступ к списку студентов в документе. 


Опт#ШаШразе 


Виртуальная функция ОптийаЮраше, вызываемая при запуске приложения, ини- 
циализирует т_р115 для последующего доступа к списку в документе. 


ОпИрадае 


Виртуальную функцию ОпОраше вызывает как функция ОппийяЮраше, так и 
СРоситет::ОражщеАШЛеи. ОпОражше устанавливает текущее положение на нача- 
ло списка и отображает его первый элемент. В данном случае функция Ораа- 
АШЙеи5 вызывается только по команде Сеаг АЦ (меню Еай). В приложении с не- 
сколькими представлениями данных в ответ на обновление документа из друго- 
го окна представления может понадобиться иная стратегия установки перемен- 
ной т роз#Шоп в классе СЕх1 56 Иеш. 


Защищенные виртуальные функции 


Перечисленные ниже функции — защищенные виртуальные функции, специаль- 
но предназначенные для работы с объектами СЯиает: саЕпиу, ГтзепЕп!иу и Сеат- 
Етху. Чтобы выделить в базовый класс универсальные средства обработки спис- 
ков, эти функции надо переместить в производный класс. 


Тестирование программы Ех15Б 


Заполните поля ввода и, чтобы вставить запись в список, нажмите кнопку: 


| 


Повторите эту операцию еще несколько раз, стирая предыдущие данные из по- 
лей ввода щелчком кнопки С!еаг. Закрыв приложение, вы должны увидеть в окне 
вывода отладочной информации примерно такую запись: 


а СЕх1560ос ат $411600 
М_${г111е = п1111е9 
т_${гРатпМаме = 
т_0№Мо9111е94 = 1 
п_рбосТетр1афе = $4113Е1 


а С0511${ ат $411624 
м11П 4 е1етепт$ 

а СЗтидепт{ а{ $412770 
п_$+гМате = Е1зпег, [оп 
п_пбгаде = 67 

а СЗтидеп{ а{ $412Е80 
п_$тгМате = Меуегз, 115а 
т_пбгаде = 80 

а СЗтидеп{ а{ $412880 
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т_5{гМаме = 5едвег$, уопп 
т_пбгаде = 92 

а СЗфидепе аЁ $4128Е0 
п_эЕгМаме = Апдегзоп, Воб 
т_пбгаде = 87 


Пара упражнений для читателя 


Возможно, вы заметили, что на панели инструментов нет кнопки, позволяющей 
модифицировать запись о студенте. Попробуйте сами добавить ее и обработчи- 
ки сообщений. Самой сложной задачей должно быть создание изображения для 
КНОПКИ. 

Вспомните, что класс СЕх15Иеи) почти готов к тому, чтобы стать универсаль- 
ным базовым. Попытайтесь выделить виртуальные функции с кодом, характерным 
для СЗшаеть, в производный класс. А потом создайте другой производный класс, 
который будет использовать новый класс элементов списка, отличный от С5идеиЕ. 


ГЛАВА 


16 


Чтение и запись документов 


Батыя вы обратили внимание, что в каждой программе, сгенерированной МЕС 
АррИсайоп УЛхага, есть знакомое меню ЕЦе с командами Му, Ореп, 5ауе и 5ауе 
А5. В этой главе вы узнаете, как заставить приложение реагировать на них, т.е. 
считывать и записывать документы. 

Вы познакомитесь как с $0]1- (Зе Роситепе ИмегЁасе), так и с МО!-програм- 
мами (Мшаре РоситепЕ ИцегЁасе). Мы углубимся в теорию каркаса приложений, 
в том числе рассмотрим множество вспомогательных классов, о которых до сих 
пор не было сказано ни слова. Путь предстоит трудный, но поверьте: это действи- 
тельно нужно, иначе вы не сумеете эффективно использовать потенциал каркаса 
приложений. 

В этой главе три программы-примера: 5О[-приложение, МО!Т-приложение на 
основе программы Ех15Ь из предыдущей главы и МТ1-приложение (Мшаре Тор- 
Теуе! ИцегЁасе). Во всех есть документ со списком студентов и вид, производный 
от класса СЕоттИеи. Теперь список студентов можно будет сохранять на диске и 
считывать с него, применяя сериализацию. 


Понятие сериализации 


В мире объектно-ориентированного программирования существуют постоянные 
(регязере) объекты, которые можно сохранять на диске при завершении програм- 
мы и восстанавливать при следующем запуске. Такой процесс сохранения и вос- 
становления объектов называется сериализацией (зепа!тайоп). Поддерживающие 
се классы библиотеки МЕС содержат функцию-член 5епайзе. Когда каркас при- 
ложений вызывает ее, скажем, для объекта класса СУиаеть, данные о студенте либо 
сохраняются на диске, либо считываются с него. 

В библиотеке МЕС сериализация не заменяет систему управления базами дан- 
ных. Все объекты, связанные с конкретным документом, последовательно считы- 
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ваются или записываются в один дисковый файл. Доступ к отдельным объектам в 
файле по произвольным адресам невозможен. Если вашей программе нужны сред- 
ства управления базами данных, подумайте об использовании средств доступа к 
базам данных в МЕС и АП, (АсНуе Тетрие ИАБгагу). 


Дисковые файлы и архивы 


Как узнать, что должна делать функция 5етайхе: считывать или записывать дан- 
ные? Как она связывается с дисковым файлом? В МЕС-библиотеке дисковые фай- 
лы представляются объектами класса СЕйе. Объект СЕйе инкапсулирует описатель 
двоичного файла, возвращаемый \п32-функцией СтешеЕйе. Это не указатель на 
структуру ЕШЕ буферизованного файла, возвращаемый функцией /ореп стандарт- 
ной С-библиотеки, а именно описатель двоичного файла. Каркас приложений 
использует его при вызовах \/1132-функций КеааЕйе, УтиеЕйе и 5еейеРойцег. 

Если программа не выполняет прямые операции ввода/вывода на диск, а по- 
лагается на сериализацию, явной работы с объектами СЁЕйе можно избежать. «Между» 
функцией 5епайзе и объектом СЕЙе располагается объект-архив класса СА’тсЬше 
(рис. 16-1). Он буферизует данные для объекта СЕйе и поддерживает внутренний 
флаг, указывающий, записывается или считывается архив с диска. С каждым фай- 
лом в каждый момент времени связывается только один активный архив. За со- 
здание объектов СЁйе и САтсЬ ре, открытие дискового файла для объекта СЕйе и 
привязку объекта-архива к файлу отвечает каркас приложений. Все, что вам ос- 
тается сделать в своей функции $еайзе, — сохранить/загрузить данные в/из объек- 
та-архива. Каркас приложений вызывает функцию 5етайзе класса документа при 
обработке команд Ореп и 5$ауе из меню ЕЙе. 


Объект се | 


Функция Зепа!те 
вызывается каркасом 
приложений при обработке 
команд Ореп и Зауе 

из меню Ее 


Рис. 16-1. Процесс сериализации 


Создание сериализуемого класса 


Чтобы стать сериализуемым, класс должен быть производным (прямо или косвен- 
но) от СОБес. Кроме того, в объявлении класса должен присутствовать макрос 
ДЕСГАКЕ_ЗЕМАГ, а в файле реализации — макрос 1МРЕЕМЕМТ_$ЕЮАГ. (Описание этих 
макросов см. в «МЕС ШЬгагу КеГегепсе».) Мы внесем эти макросы в класс С$мает 
из главы 15 и будем использовать его в следующих примерах. 
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Создание функции $ема!2те 


В главе 15 мы создали класс Сие, производный от СОБесь с такими перемен- 
ными-членами: 


риб11с: 
(51г1п9  м_5{гМате; 
111 т_пбгаае; 


Теперь напишем для класса СЯшает функцию 5етай?2е. Так как это виртуаль- 
ная функция класса СОБ/ес, типы ее параметров и возвращаемого значения дол- 
жны совпадать с объявленными в СОБес!. Вот функция 5епайе для класса СУшаепЕ 


\019 С5фидепт: :$ег1а112е(САгсп1\е& аг) 
{ 
ТВАСЕ("Епфег1пд СЭфидеп*: :3ег1а117е\п “) 
11 (аг. 1350г119()) { 
аг << т_5{гМате << т_пбгаде; 
} 
е1зе { 
аг >> т_з{гМате >> тм_пбгаае; 


Обычно функции сериализации вызывают 5е7айзе соответствующего базово- 
го класса. Если бы СУшает был производным, скажем, от СРегзоп, первая строка 
в ней выглядела бы так: 


СРегзоп: :5ег1а117е(аг); 


Функции $епай2е для класса СОБуесЕ (и СРоситета, если он не переопределяет 
эту функцию) не делают ничего полезного, так что вызывать их нет смысла. 

Заметьте: а’ — это параметр, ссылающийся на объект «архив» приложения. Фун- 
кция-член САгсрйе::155юттв сообщает, как архив используется в настоящий мо- 
мент: для записи или считывания. У класса САгсбйе перегружены операторы вставки 
(<<) и извлечения (>>) для многих встроенных типов С++ (табл. 16-1). 


Табл. 16-1. Типы, поддерживаемые операторами вставки (<<) и извлечения (>>) 


Тип данных Описание 

ВУТЕ 8 разрядов, беззнаковый 
№9)49) 16 разрядов, беззнаковый 
ГОМС ‚ 52 разряда, знаковый 
О\ОКО 52 разряда, беззнаковый 
Воа( 52 разряда 

РочЫе 64 разряда, стандарт 1ЕЕЕ 
пи 52 разряда, знаковый 
Вой 16 разрядов, знаковый 
СрБаг 8 разрядов, знаковый 


Опявпе4 52 разряда, беззнаковый 
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Операторы вставки перегружены для приема параметров по значению, а опе- 
раторы извлечения — по ссылке. Иногда приходится прибегать к преобразованию 
типов, чтобы избежать ошибок компиляции. Допустим, имеется переменная-член 
т_пТуре перечислимого типа. Вот какой код надо написать: 


аг << (111) п_пТуре; 
аг >> (111&) п_пТуре; 


У таких МЕС-классов, как С5те и СКеср не являющихся производными от 
СОБесь, есть свои перегруженные операторы вставки и извлечения для САгсре. 


Загрузка из архива: внедренные объекты и указатели 


Допустим, в объект С5/идеий внедрены другие объекты, не являющиеся экземпля- 
рами стандартного класса вроде С5йтр, С54е или СКес!. Добавим к классу Суиает 
новую переменную-член: 


риб11с: 
СТгапзсг1рЕ м_гапзсг1 рт; 


Будем считать, что СТтаизстрЕ — некий нестандартный класс (производный от 
СОЩесь, у которого есть собственная функция 5етайе. Для СОБуес не предусмот- 
рены перегруженные операторы << и >>, поэтому функция С5{идет::5епайзе при- 
обретает вид: 


\014 СЗТидепт: :Зег1а112е(САгсп1\е& аг) 
{ 
11 (аг. 1$9%0г119()) { 
аг << м_з&гМате << м _пбгаае; 
} 
е1зе { 
аг >> м_$&гМате >> т_пбгаде; 
} 


_Тгапзсг1 рт. 5ег1а117е(аг): 


Прежде чем вызывать функцию С$идеп!::5етайее для загрузки из архива записи 
о студенте, надо создать объект С5{и4ет!. Внедренный объект 7т_{тапзсирЕ класса 
СТгапзст рЕ создается вместе с объектом С5{идет! перед вызовом функции СТгапз- 
стри::бепайзе. Последняя может загрузить из архива соответствующие данные во 
внедренный объект 7и_апзси У. Запомните одно правило: для внедренных объектов 
классов, производных от СОБес, функция 5етайзе вызывается явно. 

Теперь допустим, что С5идет! вместо внедренного объекта содержит указа- 
тель на СТгапзспрё 


риб11с: 
СТгап$сг1рЕ»* м_рТгапзсг1рт; 


Можно было бы вызвать функцию 5$епайзе, как показано ниже, но при этом 
пришлось бы самостоятельно создавать объект СТгаизситри 


\014 С5ЗТидепт: :3ег1а112е(САгси1\уе& аг) 
{ 
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1! (аг. 1$5%0г1п9()) { 
аг << м_з{гМате << т_пагаде; 

} 

е1зе { 
т_рТгапзсг1рЕ = пем СТгапзсг1рт; 
аг >> м_5{гМате >> м_п@гаае; 

} 


т_рТгапзсг1рт->5ег1а117е(аг); 


Поскольку операторы вставки и извлечения в САтсрйе для указателей на СОБес! 
на самом деле перегружены, можно написать функцию 5етай2е и так: 


\014 С5фидепт: :5ег1а117е(САгсн1\уе& аг) 
{ 
1{ (аг. 1$5%0г119()) { 
аг << т_з{гМате << т_пбгаде << т_рТгапзсг1ре; 
} 
е1зе { 
аг >> тм_з{гМате >> п_пагааде >> п_рТгапзсг1 рт; 


Для создания объекта СапзсрЕ при загрузке данных из архива служат мак- 
росы РЕСГАКЕ_$ЕЮМАЕ и [МРЕЕМЕМТ 5ЕЮМАГ из класса СТгапзсиру. Когда объект 
СТгапзспру записывается в архив, эти макросы заботятся о занесении туда вместе 
с данными и имени класса. При загрузке архива считывается имя класса, и дина- 
мически создается объект нужного класса под управлением сгенерированного 
макросами кода. После того как объект СТгаизсирт сформирован, можно вызвать 
переопределенную для класса СТгапзстру функцию 5$епай2е, чтобы считать дан- 
ные из дискового файла. 

И последнее. Указатель на СТгапзсире сохраняется в переменной-члене т_рТгап- 
5спра. Чтобы избежать «утечки памяти», убедитесь, что в и р/Тапзс ре еще не за- 
несен указатель на объект СТгапзсирт. Если объект Сбшаеп! только что создан (а 
не загружен из архива), указатель на СТгапзсиру будет нулевым. 

Операторы вставки и извлечения не работают с внедренными объектами 
классов, производных от СОБесё 


аг >> т_о{гМате >> т_п@гаде >> 8м_1гапзсг1р{; // никогда так не делайте 


Сериализация наборов 


Так как все классы наборов — производные от СОБ/ес и в их объявлениях при- 
сутствует вызов макроса ДЕСГАКЕ $ЕКШГ, для сериализации наборов достаточно 
просто вызвать функцию 5ейайзе соответствующего класса набора. В частности, 
вызов 5е7ай2е для набора СОШ15 объектов СУ и4е инициирует вызов функции 
$епайзе для каждого объекта Сшает. Но при этом не забывайте об особеннос- 
тях процесса загрузки наборов из архива: 


Ш ссли набор содержит указатели на объекты разных классов, каждый из кото- 
рых происходит от СОБес, имена этих классов сохраняются в архиве, чтобы 


344 Часть !! Архитектура «документ-вид» в МЕС 


потом можно было корректно восстановить объекты конструктором соответ- 
ствующего класса; 

Ш ссли объект-контейнер (скажем, документ) содержит внедренный набор, загру- 
жаемые данные добавляются к текущему содержимому набора, поэтому не 
исключено, что перед загрузкой из архива вам придется очистить такой на- 
бор; обычно это делается в виртуальной функции РеееСотшеп5, вызываемой 
каркасом приложений; 

Ш когда из архива загружается набор указателей на СОБеср над каждым объек- 
том в наборе выполняются следующие операции: 

С определяется класс объекта; 

СО для объекта выделяется память из кучи; 

О в выделенную память загружаются данные объекта; 
С указатель на новый объект сохраняется в наборе. 


Сериализация внедренного набора объектов С5{и4ет! описана в программе 
Ех16ба. 


Функция 5ема/!те и каркас приложений 


Итак, теперь вы знаете, как писать функции 5ейайе и что их вызовы могут быть 
вложенными. Но знаете ли вы, когда вызывается первая функция 5е74айе для за- 
пуска процесса сериализации? В каркасе приложений все связано с документом 
(с объектом класса, производного от СРоситеп®. При выборе команды 5ауе или 
Ореп из меню ЕШе каркас приложений создает объект СА’срй»е (и соответствую- 
щий объект СЁЕйе), после чего вызывает функцию 5етайе из вашего класса доку- 
мента, передавая ссылку на объект САтсЬ ле. Затем функция 5етай2е производно- 
го класса документа выполняет сериализацию всех его постоянных (не времен- 
ных) переменных-членов. 
зан 
Примечание Присмотревшись к какому-нибудь классу документа, сгенериро- 
ванному МЕС АррИсаНоп УЛгага, вы заметите, что вместо макросов ОЕ- 
СТАКЕ ЗЕЮЩАГ и [МРЕЕМЕМТ _5ЕМАЕ в нем применяются макросы ДЕСГА- 
КЕ_РУМСКЕАТЕ и ПИРГЕМЕМТ _РУМСКЕАТЕ. Макросы 5ЕКГАГ не нужны, так 
как объекты-документы никогда не используются вместе с оператором 
извлечения САтсрйе и не включаются в наборы; каркас приложений вы- 
зывает функцию 5еаИзе документа напрямую. Макросы РЕСГАКЕ _$ЕЮМАЕ 
и /МРЕЕМЕМТ_5ЕЮМА!. предназначены для остальных «сериализуемых» 
классов. 


$0!-приложение 


Вы уже видели целый ряд $0!-приложений с одним классом «документ» и одним 
классом «вид». В этой главе мы по-прежнему будем работать с единственным клас- 
сом «вид», но постараемся исследовать взаимосвязи между объектом-приложени- 
ем, основным окном-рамкой, документом, его представлением, объектом — шаб- 
лоном документа и связанными с ними ресурсами строк и меню. 
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Объект-приложение МИтдом!$ 


Для каждого из ранее рассмотренных приложений МЕС АррИсаНоп УЛгагА авто- 
матически генерировал класс, производный от Старр, и создавал оператор: 


СМуАрр тпеАрр; 


Здесь мы видим механизм запуска приложения, создаваемого на базе МЕС. Класс 
СМуАрр происходит от Старр, а ФеАрр — глобальный экземпляр данного клас- 
са, называемый объектом-приложением \/п4о\5. 

Теперь рассмотрим последовательность операций, выполняемых при запуске 
УЛпао\5-приложения на базе МЕС. 


1. Уп9о\5$ загружает программу в память. 

2. Создается глобальный объект Старр. (Все глобально объявленные объекты 
формируются в момент загрузки программы.) 

5. УЛпаоу%$ вызывает глобальную функцию ИмМат, которая является частью МЕС- 
библиотеки. (ИмМат эквивалентна функции тат приложений текстового 
режима; обе — главные точки входа в программу.) 

УйиМат отыскивает единственный экземпляр класса, производного от СИмАрр. 

5. УтМат вызывает для феАрр функцию-член ийтяЯапсе, переопределенную в 
вашем производном классе приложения. 

6. Переопределенная функция ийтяаисе инициирует загрузку документа и со- 
здание основного окна-рамки и окна представления. 

7.. ИтМат вызывает для ФеАрр функцию-член Кии, которая организует распре- 
деление оконных и командных сообщений. 

Вы можете переопределить и другую важную функцию-член СИтАрр — ЕхИт5- 
1апсе, вызываемую при завершении приложения после закрытия всех его окон. 


Примечание \/п4о\ допускает одновременное выполнение нескольких эк- 
земпляров программы. Функция иШиз$апсе вызывается всякий раз, ког- 
да запускается новый экземпляр программы. В \/Лп352 каждый такой эк- 
земпляр — отдельный процесс. И то, что на виртуальные адресные про- 
странства каждого процесса проецируется один и тот же код, — лишь 
совпадение. Если нужно найти другие выполняемые экземпляры програм- 
мы, вызовите \/1132-функцию Ема\тао или — для связи между про- 
цессами — определите общую секцию данных или файл, проецируемый 
в память. 


Класс шаблона документа 


Взгляните на функцию /иШияапсе, сгенерированную МЕС АррИсаНоп УЛгагА для 
вашего производного класса приложения: 


051191е0осТетр1ате» рбосТетр1ате; 
рбосТетр1ате = пем С51п91ебосТетр1ате( 
ТОН_МАТМЕВАМЕ, 
ВИМТТМЕ_СТА$5 (СЕх1бадос), 
ВОМТТМЕ_С1А$5 ( СМа1пЕгате), // тали $0Т Ргате м1пдом 
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ВОМТТМЕ_СЕА$З (СЕх1ба\1ем)); 
АдаросТетр1ате (рбосТетр1ате); 


Если вы не собираетесь использовать разделяемые окна или множественные 
представления данных, то с объектом «шаблон документа» вы встретитесь факти- 
чески только в этом месте программы. В данном случае это объект класса Сбиае- 
РосТетр/ие, производного от СРос7етрще. Класс СУтшеросТетриие применяет- 
ся только в $П1-приложениях, так как в них не бывает нескольких объектов «до- 
кумент». Что касается Ааарос1етрше, то это функция-член класса С\ЙмАфр. 

Вызов АЯарос1етрше (совместно с вызовом конструктора шаблона докумен- 
та) устанавливает взаимосвязь классов приложения, документа, окна представле- 
ния и основного окна-рамки. Объект-приложение, конечно, существует и до со- 
здания шаблона, но объектов «документ», «рамка» и «вид» в этот момент еще нет. 
Каркас приложений создает их динамически, когда это необходимо. 

Такое динамическое создание объектов — пример искусного использования 
языка С++. Поскольку в определении и реализации класса присутствуют макросы 
ДЕСГАКЕ_РУМСКЕАТЕ и МРЕМЕМТ РУМСКЕАТЕ, библиотека МЕС способна созда- 
вать объекты класса динамически. Без этого в программу пришлось бы жестко «за- 
шить» намного больше взаимосвязей между классами приложения. Так, в произ- 
водном классе приложения понадобился бы код для создания документа, его пред- 
ставления и рамки как объектов конкретных производных классов. Это наруши- 
ло бы объектно-ориентированную природу программы. 

В системе, основанной на шаблонах, нужен лишь макрос КИМИМЕ (15$. За- 
метьте: чтобы макрос работал правильно, надо указать в нем объявление класса. 


Объект 
СИИПАр 


Рис. 16-2. Взаимосвязи классов 


На рис. 16-2 показаны взаимосвязи классов, а на рис. 16-3 — объектов. У $0]- 
приложения только один шаблон (и ассоциированные с ним группы классов), а 
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во время его работы — только один объект документа и один объект основного 
окна-рамки. 


СитАрр | 


СЕатейта | 


СБоситет 


г! 
1! 
1! 
11 
ГЕ, 
1! 
1! 
1 
1! 
10 
г! 
р 
г! 
г! 
ь7 
= 
1 
1 
1 
1 
1 
1 
1 
1 
1 
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Примечание Динамическое создание объектов существовало в МЕС-библио- 
теке еще до появления в языке С++ возможности идентификации ти- 
пов в период выполнения (гапйте гуре 1Ааепийсайоп, ВТТО. Однако сред- 
ства МЕС значительно превосходят возможности ВТТТ, и МЕС-библио- 
тека продолжает для динамического создания объектов использовать 
именно их. 


Ресурс шаблона документа 


Первый параметр функции Ааарос1етрище — )РК_МАШМЕКАМЕ, идентификатор 
строкового ресурса. Вот что МЕС АррИсаНоп УЙтага генерирует в ВС-файле про- 
екта Ех16а: 


ТОВ_МАТМЕВАМЕ 


“Ех1ба\п” // заголовок окна приложения 

а // основа для имени документа по умолчанию 
// (если не задано, то “Упе1{ед”) 

"Ех1ба\п” // имя типа документа 

“Ех1ба Е11е$ (*.1ба)\п” // описание типа’ документа и фильтр 

". 1ба\п” // расширение документов этого типа 

“Ех1ба. Воситеп*\п" // идентификатор типа файла в реестре 

“Ех1ба. Воситепт" // описание типа файла в реестре 


поддерживается. Взгляните на файл Ех1ба.гс: отдельные «подстроки» 
собраны в одну длинную строку. 
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1РК_МАПМЕКАМЕ определяет одну строку, разбитую на подстроки разделителем 
строк (\п). Эти подстроки отображаются на экране в тот или иной момент ис- 
полнения программы. Строка 16а — расширение файлов документов по умолча- 
нию, заданное для МЕС АррИсаНоп У/1тага. 

Кроме строк, идентификатор 2К_МАГМЕКАМЕ определяет значок приложения, 
ресурсы панелей инструментов и меню. Эти ресурсы генерирует МЕС АррИсацоп 
УЙ1гага, а программист работает с ними через редактор ресурсов. 

Итак, вы увидели, как шаблон АааросТетриие связывает воедино все элемен- 
ты приложения. Но пока не создано ни одного окна, на экране ничего нет. 


Множественное представление документа в $0|-программах 


Поддержка нескольких представлений документа в 301-приложении более замыс- 
ловата. Можно просто определить элемент меню, позволяющий выбрать конкретное 
представление данных, или же создать несколько представлений в разделяемом 
окне. Оба способа мы рассмотрим в главе 18. 


Создание пустого документа: функция СИ/пАрр::ОпЕЙеМеи 


Функция ийтяапсе вашего класса приложения, вызвав функцию-член АЯаос- 
Тетриие, затем вызывает (неявно, через СУтАрр::Ргосе$з фейСоттапа) другую 
важную функцию-член класса СмАрр — ОпЕйеМеш. Последняя, обращаясь к СМ- 
Абр::ОрепроситепИ йе, распутывает «паутину» взаимосвязанных имен классов и 
делает следующее. 


1. Создает объект-документ, не пытаясь считать данные с диска. 

2. Создает объект основного окна-рамки (класса СМатЕгате) и основного окна, 
но не отображает их на экране. У основного окна-рамки есть меню ШК _МАИМ- 
ЕКАМЕ, панель инструментов и строка состояния. 

3. Формирует объект «вид» и соответствующее окно, не отображая его на экране. 

4. Устанавливает связи между объектами «документ», «основное окно» и «представ- 
ление». Не путайте связи между объектами со связями между классами, уста- 
новленными вызовом АЯарос1етр ее. 

5. Вызывает для объекта «документ» виртуальную функцию-член СРоситепЕ:Оп- 
№ еиоситет, которая обращается к виртуальной функции РеееСотшеик. 

6. Вызывает для объекта «вид» виртуальную функцию-член Стеш::ОтттаЮрае. 

7. Вызывает для объекта-рамки виртуальную функцию-член СЕгатепа::Астеие- 
Етате, чтобы вывести на экран основное окно-рамку вместе с меню, окном 
представления, панелью инструментов и строкой состояния. 


Е циння 


Примечание Некоторые из перечисленных функций вызываются не из Ореп- 


Роситеп! Ее, а неявно самим каркасом приложений. 
р 


В $ОГ-приложении объекты «вид», «документ» и «основное окно-рамка» созда- 
ются только раз и существуют на протяжении всей жизни программы. Функцию 
суйтАрр::ОпЕЙеМеи вызывает функция иШияапсе. Кроме того, она вызывается в 
ответ на выбор в меню ЕЙе команды Мех. В данном случае ОпЕйеМеи должна ве- 
сти себя иначе. Она не формирует объекты «вид», «документ» и «рамка», так как 
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они уже созданы. Вместо этого она использует существующие объекты повторно 
и выполняет операции 5, 6 и 7. Заметьте: ОпЕЙеМеиш всегда вызывает (неявно) 
ревеСотети$ для очистки документа. 


Функция ОпМеи/Эосите! класса «документ» 


В главе 15 вы уже встречали функцию-член класса «вид» ОпийяЮраше и функ- 
цию-член ОйМешРосите класса «документ». Если бы $П]1-приложение не исполь- 
зовало объект-документ повторно, ОиМешОоситет! была бы не нужна, так как всю 
инициализацию документа можно было бы провести в конструкторе его класса. 
Но в реальности вы должны переопределить ОпМешоситет, чтобы инициали- 
зировать объект-документ всякий раз, когда пользователь выбирает в меню ЕЦе 
команду Меу\у или Ореп. МЕС АррИсаНоп \У/Л2ага поможет вам в этом, создав заго- 
товку функции в сгенерированном производном классе документа. 


Примечание Неплохо бы свести к минимуму объем операций, выполняемых 
в конструкторах. Чем их меньше, тем ниже вероятность сбоя в кон- 
структоре — а такие ошибки могут иметь тяжкие последствия. Функции, 
подобные СРоситеш::ОпМ№ешДоситеш и СТеиш::ОттийаЮраше, — идеаль- 
ное место для начальной очистки. Если возникнут проблемы, вы сможете 
вывести сообщения в информационном окне, а при вызове ОиМ№еиоси- 
тет — возвратить ЁЕ4[5Е. Обе функции можно вызывать для данного 
объекта неоднократно. Если какие-то действия надо выполнить один раз, 
объявите специальную переменную-член (флаг) — она послужит призна- 
ком «первого вызова». 


Связывание Ее Ореп с кодом сериализации: 
функция ОпРЙеОреп 


Генерируя приложение, МЕС АррИсайоп У/Л2аг4 сопоставляет команде Ореп из меню 
ЕЦе функцию-член СУтАрр::ОпЕйЙеОреи, которая делает следующее. 
1. Предлагает пользователю выбрать файл. 


2. Вызывает виртуальную функцию-член СРоситет::ОпОрепроситей для суще- 
ствующего объекта-документа. Та открывает файл, вызывает Сроситет.:реее- 
Сотет 5, создает объект САгсре, подготовленный для загрузки, и вызывает 
функцию 5ептайзе документа, которая загружает данные из архива. 

Вызывает функцию ОйийеЮраше класса «вид». 

Альтернатива команде Ореп меню ЕЦе — список последних открывавшихся 
файлов (Мозг Весепйу Озеа, МВП). Каркас приложений запоминает последние 
4 файла и отображает их имена в меню ЕЦе. В промежутке между запусками про- 
граммы эти имена хранятся в реестре УЛп4оуу. 


<> 


Примечание Можно изменить число запоминаемых файлов, вызвав с соответ- 
ствующим параметром функцию Года ю@ЯРгоШе$еште в функции тИт- 
$атсе класса приложения. 
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Функция Бе/е{еСотепт!$ класса «документ» 


При загрузке данных из дискового файла в существующий объект-документ $01 
надо стереть текущее содержимое объекта. Лучший способ — переопределить 
виртуальную функцию СРоситепЕ:РаееСотепв в производном классе докумен- 
та. Как вы видели в главе 15, такая переопределенная функция делает все, что нужно 
для очистки переменных-членов класса документа. При выборе в меню ЕйЙе команд 
№ \ и Ореп функции ОпЕйе№еш и ОпЕИеОреп класса СБоситет обращаются к 
РевеСотет5, а значит, она вызывается сразу после создания объекта-документа 
(и вновь вызывается при закрытии документа). 

Чтобы ваши классы документов работали в $01-приложениях, очищайте содер- 
жимое документа в функции РевеСотетк, а не в деструкторе. Последний исполь- 
зуйте только для очистки элементов, существующих на протяжении всей жизни 
объекта. 


Связывание [йе $ауе и РИе $ауе Аз с кодом сериализации 


МЕС АррИсаНоп УЛ2ага, генерируя приложение, сопоставляет команде Зауе меню 
ЕЙе функцию-член ОпРЙе$аше класса СБоситепЕ Последняя вызывает функцию 
Оп5аиеВоситет класса СРоситеть, которая в свою очередь обращается к функ- 
ции 5еайзе документа, передавая ей объект-архив, подготовленный для сохра- 
нения. Команда 5ауе Аз из меню ЕЦе обрабатывается аналогично — ей сопостав- 
ляется функция ОпЕйЙе$ареА$ класса Сроситет, которая вызывает Оибаоероситене 
Все операции с файлами, необходимые для сохранения документа на диске, осу- 
ществляет здесь каркас приложений. 


Примечание Очевидно, что командам ЕЙе Ме\ и ЕЦе Ореп сопоставляются 
функции-члены класса приложения, а Ейе Зауе и ЕЙе $ауе Аз связывают- 
ся с функциями-членами класса документа. Ее Меу связана с ОпЕЙеМеш. 
Версия иШияапсе для $Г1-приложения тоже вызывает ОиЕйеМеш (неявно). 
Объект-документ не существует в момент вызова [иизатсе каркасом при- 
ложений, поэтому ОиРйеМ№е не может быть функцией-членом СБоситепЕ 
Но при сохранении документа объект-документ, разумеется, существует. 


Флаг изменения документа 


Многие приложения УЛпдо\у5, ориентированные на документ, отслеживают из- 
менения в нем. При закрытии документа или выходе из программы появляется 
окно с запросом, сохранить ли текущий документ. Каркас МЕС-приложений под- 
держивает такое поведение при помощи переменной-члена 7и_ЬМо@йПеа класса 
СРоситет. Эта логическая переменная равна ТКИЕ, если документ изменен (ау) 
и ЕА[ЗЕ, если нет. 

Доступ к защищенному флагу 7и_Ь Моей осуществляется через функции-члены 
5еМоайеаНав и [5Моййе4 класса СРоситети. Когда документ создается, открыва- 
ется или сохраняется на диске, флажок объекта-документа устанавливается в ЕАГЗЕ. 
При изменении его данных нужно устанавливать этот флажок в ТКИЕ с помощью 
5еМоййеаНар. Виртуальная функция СРоситет!::5 аоеМоййеа, которую каркас 
приложений вызывает, когда пользователь закрывает документ, отображает инфор- 


И 
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мационное окно, если флажок т_ЬМоййеа установлен в ТКОЕ. Если вам нужно 
выполнить другие действия, переопределите эту функцию. 

В примере Ех1ба вы увидите, как простейшая функция, обновляющая команд- 
ный пользовательский интерфейс, с помощью [5Моайей управляет состоянием 
кнопки на панели инструментов и командой в меню, обеспечивающих доступ к 
сохранению документа. При изменении документа кнопка на панели инструмен- 
тов с изображением дискеты активизируется, а когда пользователь сохраняет файл, 
она блекнет. 


Примечание $01-программы, написанные на базе МЕС, ведут себя несколько 
иначе, нежели другие $0]1-приложения для УЛп9оу\з вроде Могераа (Блок- 
нот). Типичная последовательность событий выглядит так: 

1. пользователь создает документ и сохраняет его на диске, скажем, как 
(езс.Чаг; 
2. пользователь изменяет документ; 


5. пользователь выбирает команду Ореп из меню ЕЦе и указывает файл 
сезс.Чаг. 


При выборе команды ЕЦе Ореп программа Могера4 спрашивает, со- 
хранить ли изменения в документе, сделанные на этапе 2. Если пользо- 
ватель отвечает «нет», программа вновь считывает документ с диска. 
Приложение на МЕС считает изменения постоянными, не перезагружая 
при этом файл. 


Пример Ех1ба: сериализация в $01-документе 


Программа Ех1ба очень похожа на Ех15Ъ. Диалоговое окно для ввода информа- 
ции о студенте и растровые изображения — те же, класс «вид» тоже не изменил- 
ся. Но в Ех1ба мы добавим сериализацию вместе с функцией обновления коман- 
дного интерфейса для ЕЦе $ауе. Заголовочные файлы и файлы реализации для 
классов «вид» и «документ» из этого примера будут использованы и в Ех16Ь. 

Далее приведен весь новый код, отличающийся от кода Ех15Ъ, причем выде- 
лены все дополнения и изменения по сравнению с кодом, сгенерированным ма- 
стерами. Список файлов и классов в Ех1ба сведен в табл. 16-2. 


Табл. 16-2. Файлы и классы программы Ех1ба 


Заголовоч- Файл с исход- 
ный файл ным кодом Класс Описание 
Ех1ба.В Ех16ба.срр СЕх1баАрр Класс приложения (создан МЕС 
АррИсайоп УЛтага) 
САБОИН8 Диалоговое окно АБош 
МашЕгл.В МашЕнтм.срр СМатЕтате Основное окно-рамка $П1-приложения 


Ех1барос.В Ех1барос.срр СЕх1баос Документ с данными о студенте 
Ех1ба\е\Ь — Ех1ба\еу’срр СЕх1ба\еи Представление информации 

о студенте (из Ех15Ь) 
Зааепе.В Ушаепесрр Сушаей Запись о студенте 


З3ААЕХ.В (ААЁх.срр Предкомпилированные заголовочные 
файлы (с добавлением аЁиетрИ.В) 
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СЗшает 


Файл Зиаепе.В из Ех1ба практически тот же, что и в проекте Ех15Ъ. Заголовоч- 
ный файл вместо: 


ОЕСЕАВЕ_ЗЕВТА (СЗ+идеп*) 

содержит макрос: 
ОЕСЕАВЕ_БУМАМТС ( СЗТидепе) 

а файл реализации вместо: 
ТМРЕЕМЕМТ_ЗЕВТАЕ(С$тидепт, С063ес+, 0) 


содержит макрос: 


ТМРЕЕМЕМТ _ОУМАМТС ( СЗфиаепе, С064ес+) 


Кроме того, добавлена виртуальная функция 5еайхе. 


СЕх1баАрр 


Файлы класса приложения в этом приложении содержат только код, сгенериро- 
ванный МЕС АррИсаНоп \/1хага. Это приложение сгенерировано с расширением 
файла документа по умолчанию и с поддержкой запуска из М1сгозой УЛпао\$ 
Ехргег (Проводник), а также с поддержкой Чгаз-апа-агор. Эти возможности мы 
обсудим позже в этой главе. 

Чтобы сгенерировать дополнительный код, нужно при первом запуске МЕС 
АррИсайоп УЛгага на странице Роситепе Тетр!ае 511185 в ЕЦе Ежепяюоп ввести 
расширение файлов: 


МЕС АррёсаНой Уеага - Ен ба 


боситеп{ Тетр!а{е 5419$ 
Эресфу уашез Гог уошг аррйсаНог!5 Фоситеги етр/аке Ко изе иНеп сгеаНпо а печи доситеги. 


Это гарантирует, что строка ресурса шаблона документа содержит правильное 
расширение, а в функцию-член иймяапсе класса приложения внесен код под- 
держки запуска из проводника. Можно изменить и другие подстроки ресурсов. 
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СМатЕгате 


Код класса основного окна-рамки практически не изменен по сравнению с ко- 
дом, сгенерированным МЕС АррИсаНоп У/2ага. Переопределенная функция Асйще- 
Егате и обработчик сообщения УМ_РКОРЕЦАЕ$ присутствуют только для трасси- 
ровки. 
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см. след. стр. 
13—2064 
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Класс СЕх1ба)ос 


Этот класс идентичен классу СЕх156Юос из главы 15 за исключением функций 
5епайзе, ревеСотет5, ОпОрепроситет! м ОпПрашеЕйебахе. 
Зепайге 


К коду функции, сгенерированному МЕС АррИсаНоп УЛлага, добавлена всего одна 
строка сериализации списка студентов: 


ИИ ИИ ИИ 


// СЕх1бабос зег1а11тат1оп 


\014 СЕх1баПос: :5ег1а117е (САгсп1\уе& аг) 


{ 
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ТВАСЕ( "Епфег1пд СЕх1ба)ос: : $ег1а117е\п") 
1! (аг. 15510г119()) 
{ 
// 1000: ада з10г1п9 соде веге 
} 
е1зе 
{ 
// Т000: ада 10а91п9 соде пеге 
} 
п_эфидепЕЕ1 31. $ег1а112е(аг); 


БевеСотет$ 
Оператор Ритр заменен простой директивой ТКАСЕ. Вот модифицированный код: 


\014 СЕх1ба[ос: : Ое1етеСоптептт$() 
{ 
ТВАСЕ( "Епфег1пд СЕх1барос: : Ое1ефеСоптепез\п”); 
мП1]е (т_$идеп{Е1$т. бетНеадРо$1{10п()) { 
де1ефе п_зфидепеЕ1 $1. ВетоуеНеаа(); 


} 


ОпОрепбосите! 


Эта виртуальная функция переопределена только для того, чтобы вывести трас- 
сировочное сообщение: 


ВООЕ СЕХ1баос: :ОпОрепбоситепт (ЕРСТЭТН 1р$7Ра{ПМаме) 
{ 
ТВАСЕ( "Епфег1по СЕх1ба0ос: : ОпОрепбоситеп*\п”); 
ТЕ (!Сбоситепт : :ОпОрепбоситепт (1р$7РатпМаме) ) 
гетиги. РАЕЗЕ; 


// 1000: Ада уоиг зрес1а112е4 сгеа{1оп соде пеге 


гетигп ТВОЕ 


ОпИразеЕИе$ауе 


Эта функция таблицы сообщений отключает кнопку ЕЦе 5ауе на панели инстру- 
ментов, если флаг изменения документа не установлен. Класс «вид» управляет 
состоянием этого флажка через функцию 5еМоййеяЕ ав. 


у014 СЕх1бадос: ;ОпИрдафег11еауе(ССтауТ» рСтаит) 

{ 
// отключить кнопку с изображением дискеты, если файл не изменен 
рСтаут->Епаб1е(13Мо9111е49()); 
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СЕх1баМе\м 


Код класса СЕх1баТеш позаимствован из класса СЕх15Иеи (см. главу 15). 


Тестирование приложения Ех1ба 


Собрав программу, запустите ее под управлением отладчика и протестируйте, введя 
какие-нибудь данные и сохранив их на диске под именем Тез(.1 ба. (Расширение 
„1ба вводить не обязательно.) 

Выйдите из программы, перезапустите се и откройте сохраненный вами файл. 
Есть ли там введенная ранее информация? Загляните в окно отладчика и проверьте 
последовательность вызовов функций — она должна содержать сообщения о чте- 
нии и записи документа о студентах при загрузке и сохранении документа. 


Запуск программ из \Мпдомиз Ехр/огег 
и операция @гад-ап9-4гор 


В прошлом пользователи «персоналок» запускали какую-то программу, а потом 
выбирали файл (иногда называемый «документом»), который содержал данные в 
формате, понятном этой программе. Так работали многие программы для М$-2О5. 
Старый диспетчер программ УЛп4о\$ сделал запуск программы проще — двой- 
ным щелчком ес значка. В то же время пользователям Арр/е МасииозВ работать 
было еще легче: они дважды щелкали значок документа, а ОС сама определяла, какую 
программу запустить. 

В современном УЛпаоууз Ехр!огег (Проводник) программу можно запускать 
двойным щелчком не только ее значка, но и значка одного из ее документов. Но 
как проводник определяет, какую программу запускать? Для «привязки» докумен- 
та к программе применяется реестр. В основе сопоставления лежит расширение 
имени файла, которое мы определяли в МЕС АррИсаНоп \Ятага. Но запуск — это 
далеко не все. Установив связь определенного вида документов с конкретной про- 
граммой, пользователи могут запускать эту программу, дважды щелкнув значок ее 
документа или перетащив его мышью из проводника на значок программы. Кро- 
ме того, значок документа можно переместить на принтер, и программа распе- 
чатает этот документ. 


Регистрация программы 


В главе 14 мы выяснили, как сохранять данные в реестре УЛпао\$, добавив в 
функцию иШияапсе вызов 5еКедтуКеу. Независимо от того, добавили вы этот 
вызов или нет, ваша программа может при запуске записывать информацию об 
ассоциациях файлов в другую часть реестра. Для активизации этой возможности 
укажите расширение имен файлов при создании приложения средствами МЕС 
АррИсайцоп УЛ12ага, который внесет расширение в строку шаблона документа и 
вставит в функцию ийтяЯапсе вызов: 


Вед1з{егопе117Е11еТурез(Тгие); 


Теперь программа добавит в реестр два элемента. В разделе НКЕУ _СГА$5Е$ ВООТ 
она создаст подраздел и строку данных. В Ех1ба она выглядит так: 
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.16А = Ех1ба. Боситеп{ 


Первый элемент — это выбранный для вас мастером МЕС АррИсаНоп УЙгага 
идентификатор типа файла, а Ех1ба.Роситепе — раздел самой программы. Пара- 
метры подраздела Ех1ба.Роситепе, также расположенного в разделе НКЕУ_СТА$- 
5Е$_ВООТ, таковы: 


_ | февыю — ВЕб.52 с\усррпеЦЕх16а\реБид\Ех16а.ехе "%1" 


ыы 


В реестре содержится полное имя программы Ех16ба с указанием пути. Теперь 
проводник, используя реестр, может перейти от расширения к идентификатору 
типа файла и к самой программе. После того как расширение зарегистрировано, 
проводник находит значок документа и отображает его рядом с именем файла. 


Двойной щелчок документа 


Когда пользователь дважды щелкает значок документа, проводник запускает со- 
ответствующую $П[-программу, передавая ей в командной строке имя выбранно- 
го файла. МЕС АррИсаНоп УЛ2ага генерирует в функции /ийтяапсе вызов ЕпабЕе- 
5$реПОрет, что обеспечивает поддержку запуска посредством ОРЕ-сообщения. Эта 
технология применялась в ЕЦе Мапазег УЛпао\з$ МТ 3.51. УЛаао\з Ехрогег умеет 
запускать $П1-приложение и без этого вызова. 


Активизация механизма @4гад-апд-дгор 


Чтобы запущенная программа могла открывать файлы, которые пользователь 
перетаскивает в нее из проводника, вызовите функцию ОгасАссер! йе; класса Спа 
для основного окна-рамки приложения. Открытая переменная-член т_рМат\па 
объекта-приложения указывает на объект СЕгатепа (или СМРЁтатейта). Ког- 
да пользователь «бросает» значок файла внутри окна-рамки, окно получает сооб- 
щение УМ_РКОР_ЕП.В5, что приводит к вызову обработчика СЕгате\па::ОпОтор- 
Ейез. Следующая строка из ийтяапсе, генерируемая МЕС АррИсацоп УЛгага, ак- 
тивизирует открытие файлов операцией агаз-ап4-@гор:; 


т_рМа1пипа->ОгадАссертЕ11ез(); 


Параметры запуска программы 


При выборе в меню $(агЕ команды Вип или двойного щелчка значка в проводни- 
ке программа запускается без параметров в командной строке. Функция /ийтзяапсе 
обрабатывает командную строку, вызывая Ра’зеСоттапа те и Ргосез$$рейСоттапа. 
Если в командной строке содержится нечто, напоминающее имя файла, программа 
сразу загружает этот файл. Поэтому можно создать ярлык \/п90%з, который умеет 
запускать программу с заданным файлом документа. 
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Эксперименты с запуском программы 
из ММпаомз Ехрюгег и операцией агад-апд-дгор 


Собрав Ех1ба, попробуйте запустить ее из проводника. Однако сначала запусти- 
те программу как обычно, чтобы поместить в реестр начальные записи. Сохра- 
ните на диске по крайней мере один файл с расширением .1ба и закройте про- 
грамму Ех1ба. Запустите проводник и откройте каталог с 1ба-файлами. Дважды 
щелкните один из них в правой панели окна. Ваша программа должна запустить- 
ся и автоматически загрузить выбранный файл. Теперь, когда запущены и Ех1ба, 
и проводник, попробуйте перетащить другой файл из Ехр|огег в окно Ех1ба. Про- 
грамма откроет новый файл, как при выборе команды Ореп из меню Е|е. 
Возможно, вы захотите просмотреть записи в реестре УЛп4оууз, относящиеся 
к Ех1ба. Тогда запустите программу Кезеай (Кереа 32 в \Лпао\$ 2000/ХР) и рас- 
кройте раздел НКЕУ_СТА$$Е$_ВООТ. Просмотрите содержимое подразделов .16А 
и Ех1ба.Роситепи. Кроме того, раскройте раздел НКЕУ СОВВЕМТ ОЗЕК (или 
НКЕУ_О5ЕК$) и изучите подраздел зоЙ\таге. Там в разделе Ех1ба вы должны най- 
ти подраздел Кесепг ЕЦе 1155 (список последних открывавшихся файлов). Программа 
Ех1ба вызывает 5е/Кези'уКеу со строкой «оса! АррУ/гага-Сепегаиеа АррИсаНопз», 
поэтому подраздел с именем этой программы находится в разделе Ех16л. 


Работа с документами в МО]!-приложениях 


МЕС поддерживает не только $П!-приложения, но и МП1-программы. В этой гла- 
ве вы узнаете, как загружаются и сохраняются файлы документов в МПО!-прило- 
жениях. По-видимому, именно МО1-приложения лучше программировать при 
помощи МЕС. В частности, МЕС АррИсайоп \У/1гагА по умолчанию предлагает со- 
здать МО1-приложение, да и большинство примеров программ, поставляемых с 
Мисгозой У150а! С++, — это МО!-приложения. 

Вы изучите сходства и различия $10]- и МО1-приложений и научитесь преоб- 
разовывать 50]- в МО!-программы. Но приступать к изучению МО!-программ 
можно, только досконально разобравшись в материалах главы 15. 

Прежде чем обратиться к коду МЕС-библиотеки для МП!-приложений, пригля- 
димся к работе программ этого типа. Посмотрите на Ува! С++ МЕТ — это МП]- 
приложение, «множественными документами» которого выступают файлы с ис- 
ходным текстом программ. Но это не самое типичное МП]-приложение, так как 
документы в \15иа1 С++ „МЕТ группируются в проекты. Предпочтительнее иссле- 
довать М1сгозой \огА или — еще лучше — МО!-приложение на базе МЕС и сгене- 
рированное средствами МЕС АррИсайоп УЛлага. 


Типичное МО!-приложение в стиле МЕС 


Пример Ех16Ь (рис. 16-4) — это МО1-версия программы Ех1ба. 

Открыты два разных файла документов, каждый в своем дочернем МП[-окне, 
но активно только одно дочернее окно. У приложения одно меню и одна панель 
инструментов; все команды маршрутизируются в активное дочернее окно. Заго- 
ловок основного окна содержит имя файла документа, открытого в активном 
дочернем окне. 
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Ен16Ь - Ех1662 


Рис. 16-4. МО/-приложение Ех16Ь с двумя открытыми файлами 


Дочернее окно можно свернуть в значок внутри основного окна. Меню УЛп4о\ 
обеспечивает управление дочерними окнами при помощи команд: 


Команды меню Действие 

Ме УЛа4о\ Открывает дополнительное дочернее окно для текущего документа. 

Сазсаае Располагает существующие дочерние окна каскадом. 

ТИе Располагает существующие дочерние окна так, чтобы они не пере- 
крывались. 

Аггапзе [соп$ Упорядочивает значки окон в пределах окна-рамки. 


<имя документа> —Активизирует соответствующее дочернее окно и помещает его по- 
верх других окон. 


Меню и панели инструментов в МО!-приложении динамичны. Когда все окна 
закрыты, состав меню ЕЦе меняется, большинство кнопок на панели инструмен- 
тов отключается, а в заголовке окна нет имени файла. Единственное, что можно 
сделать, — создать новый документ или загрузить существующий. 

После запуска приложения создается новый документ с именем по умолчанию 
Ех16Ь1. Это имя формируется на основании значения параметра Рос Туре Мате 
(т.е. Ех16Ь), указанному на странице Росштепи Тетр!а{е 5119$ в мастере МЕС 
АррИсаНоп УЛгага. Первому новому файлу присваивается имя Ех16Ь1, второму — 
Ех16Ь2 и т. д. Но при сохранении документа пользователь обычно задает более 
информативное имя. 

МО!-приложения на базе МЕС, как и многие коммерческие МП!-программы, при 
запуске автоматически создают новый пустой документ. (В этом смысле У15иа1 С++ 
„МЕТ — исключение.) Чтобы ваша программа при запуске открывала пустое окно- 
рамку, измените аргумент в вызове РгосезфейСоттапа в файле реализации класса 
приложения, как показано в примере Ех16Ъ. 
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Объект «МО|-приложение» 


Вас наверняка интересует, как работает МО1-программа и какой код заставляет ее 
вести себя не так, как $О1-приложение. Впрочем, процесс запуска приложений 
обоих типов во многом одинаков. Объект-приложение производного от СЙмАрр 
класса включает переопределенную функцию-член иШпияаисе. Она немного от- 
личается от функции /иШИпяЯапсе $01-приложения и начинается с вызова АЯ@ос- 
Тетрше. 


Класс шаблона МО!-документа 
Вызов для создания шаблона МП! в функции иШиЯапсе выглядит так: 


СМи1{1босТетр1ате»* рбосТетр1ате: 
рбосТетр1афе = пем СМи11+1БосТетр1а*е( 
ТОВ_ЕХ1бВТУРЕ, 
ВОМТТМЕ_СЕАЗ5(СЕх16600с), 
ВОМТТМЕ_СЕАЗЗ(ССП119Егате), // специализированное дочернее окно-рамка МОТ 
ВОМТТМЕ_СЕАЗЗ(СЕх16Ь)); 
АдаБосТетр1ате (рбосТетр1ате) 


В отличие от класса СмяеросТетрие, который вы видели в Ех1ба, СМиНос- 
1Тетрие позволяет программе использовать разные типы документов и допуска- 
ет одновременное существование более чем одного объекта-документа. В этом суть 
МО!-программ. 

Единственный вызов Адарос1етре, показанный выше, позволяет МП]-про- 
грамме поддерживать несколько дочерних окон, каждое из которых связано с 
отдельными объектами «документ» и «вид». Допускается наличие нескольких до- 
черних окон (и соответствующих объектов «вид»), связанных с одним объектом 
«документ». В этой главе мы поработаем только с одним классом «вид» и одним 
классом «документ». О применении нескольких классов «вид» и «документ» см. 
главу 18. 


Примечание В процессе работы программы объект — шаблон документа под- 
держивает список активных объектов-документов, созданных с его по- 
мощью. «Проход» по этому списку обеспечивают функции-члены клас- 

‚ са СМишрос1ет ше — бсеейяДосРояиюот и Сей\ех ос. Для перехода от 
документа к его шаблону служит СРоситет::беосТетр ие. 


Окно-рамка и дочернее окно в МО!-программе 


В примерах $01-программ присутствовал лишь один класс окна-рамки и один 
объект этого класса. Для $П1-приложений МЕС АррИсацоп УЛгага генерирует класс 
СМатЕтате, производный от класса СЕтате\па. В МО1-приложении два класса 
окна-рамки и множество объектов-рамок. Взаимосвязь окна-рамки и окна пред- 
ставления в МО[-приложении показана на рис. 16-5. 
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Рис. 16-5. Взаимосвязь окна-рамки и окна представления в МЫ-программе 


В $01-приложении объект СМатЁгате обрамляет приложение и содержит 
объект «вид». В МО!-приложении эти функции разделены. Теперь в итяапсе 
создается объект СМатЕгате, а окно представления содержится внутри объекта 
сорйаЕгате. МЕС Аррйсайоп У/Л2агА генерирует такой код: 


СМа1пЕгате* рМа1пЕгате = пем СМалпЕгаме; 

1Е (!рМазпЕгаме->ГоадЕгате (ТОВ_МАТМЕВАМЕ) ) 
гетигп РАЕЗЕ; 

п_рМатпипа = рМазпЕгаме; 


рМма1пЕгате->Зпом\1пдом (т_пСтаЗпом); 
рМазпЕгате->Ирдате\м1птдом( ); 


Каркас приложений может создавать объекты ССЬЙЧЕгате динамически, так 
как указатель периода выполнения на класс ССЬИЧЕгате передается конструкто- 
ру СМширосТетр ме. 
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ани 


Примечание Функция из аисе МО1-приложения присваивает переменной- 
члену 72 рРМат\Упа класса СУтАрр указатель на основное окно-рамку. 
Это значит, что, если понадобится указатель на основное окно-рамку, вы 


сможете получить доступ к т_рМат\та через глобальную функцию 
АрсаАрр!. 
Умж 


Ресурсы основного окна-рамки и шаблона документа 


В МОГ-приложении (например, в Ех16Ь) два отдельных ресурса строк и меню, 
идентифицируемых константами ШЮ_МАМЕКАМЕ и ШК_ЕХ16ВТУРЕ. Первый ре- 
сурс используется, если основное окно-рамка пусто, а второй — если в нем есть 
дочерние окна. Вот как выглядят оба строковых ресурса, разбитые на подстроки: 
ТОВ_МАТМЕВАМЕ 

"Ех166" // заголовок окна приложения 


ТОН_ЕХ16ВТУРЕ 


А: // (не используется) 

"Ех16Ь\п” // основа для имени документа по умолчанию 
“Ех1бЬ\п” // имя типа документа 

"Ех166 [116$ (*.166)\п” // описание и фильтр для типа документа 

". 166\п” // расширение для документов этого типа 
“Ех16Ь. Воситеп*\п” // идентификатор типа файла в реестре 
“Ех16Ь. Воситейт" // описание типа файла в реестре 


аа 


Примечание Компилятор ресурсов не поддерживает конкатенацию (сцепле- 
ние) строк. Взгляните на содержимое файла Ех16Ь.гс: на самом деле 
подстроки объединены в одну длинную строку. 


Заголовок окна приложения берется из строки 2К_МАПМЕКАМЕ. При наличии 
открытого документа к заголовку добавляется имя файла этого документа. По- 
следние две подстроки из /2Ю_ЕХ16ВТУРЕ поддерживают запуск с внедрением или 
операцией агаз-ап4-Чгор. 


Создание пустого документа 


Функция СИмАрр::ОпЕЙеМеш позволяет создавать пустой документ. Как и в $0]- 
приложении, иШпяатсе в МО!-программе вызывает ОиЕЙеМеш (через Ргосе$5- 
5бейСоттапа). Однако на этот раз основное окно-рамка уже создано. Теперь же 


ОпЕйеМ№е, вызывая функцию ОрепроситешЕйе класса СМширосТетр ше, делает 
следующее. 


1. Создает объект-документ, но не пытается загружать с диска его данные. 
2. Создает объект (класса ССРИЧЕгате) дочернего окна-рамки МОГ и формирует 


это окно, не отображая его на экране. Меню /2К_МАИМЕКАМЕ в основном окне- 
рамке заменяется на меню 2К_ЕХ16ВТУРЕ. Идентификатор ШК _ЕХ1бВТУРЕ 


' Для этого годится и глобальная функция АйсеМайина. — Прим. перев. 
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определяет и ресурс значка, используемый при сворачивании дочернего окна 
в основном окне. 
5. Создает объект «вид» и формирует окно представления, не выводя его на экран. 
4. Устанавливает связь между оббектами «документ», «дочерняя рамка» и «вид». 
Не путайте эти связи между объектами со связями между классами, которые 
устанавливает вызов АЧаросТетр ие. 
Вызывает для объекта «документ» виртуальную функцию-член ОпМешоситети. 
6. Вызывает для объекта «вид» виртуальную функцию-член ОтийаЮраае. 


7. Вызывает для объекта «дочерняя рамка» виртуальную функцию-член Асйоше- 
Егате, чтобы вывести на экран это окно-рамку и окно представления. 


л 


Функцию ОиРИйеМ№еш вызывает также команда Ме\ из меню ЕйЙе. В МОГ-прило- 
жении функция ОпЕйеМеш работает так же, как и при вызове из иШияаисе. 


Примечание Некоторые из перечисленных выше функций вызываются не из 
ОрепроситепИ йе, а неявно — каркасом приложений. 


Создание дополнительного окна представления 
для существующего документа 


При выборе из меню \У/Лп4о\ команды Ме\ УЛпдо\ каркас приложений откры- 
вает новое дочернее окно, связанное с текущим документом. Соответствующая 
функция ОиИтаошМеи из класса СМЫЁЕтате\па выполняет такие действия. 


1. Создает объект дочернего окна-рамки (класса ССриаЁЕгате) и формирует само 
дочернее окно, не выводя его на экран. 
Создает объект «вид» и формирует окно представления, не выводя его на экран. 
Устанавливает связь между новым объектом «вид» и существующими объекта- 
ми «документ» и «основное окно-рамка». 
Вызывает для объекта «вид» виртуальную функцию-член ОтийеЮраие. 


5. Вызывает для объекта дочернего окна-рамки виртуальную функцию-член Асйра- 
1еРтате, чтобы вывести на экран это окно-рамку и окно представления. 


Загрузка и сохранение документов 


Документы в МО!-приложении загружаются и сохраняются практическим так же, 
как и в 5П[-программе, но есть два важных отличия: всякий раз, когда документ 
загружается с диска, создается новый объект-документ, а при закрытии дочерне- 
го окна объект-документ уничтожается‘. Об очистке содержимого документа пе- 
ред загрузкой не беспокойтесь, но функцию СРоситет::ревеСотет!; переопре- 
делите, чтобы класс документа можно было переносить в $0 1-среду. 


' Объект «документ» уничтожается, только если закрыто окно с его последним пред- 


ставлением. Если же есть окна с другими представлениями документа, он продолжает 
существовать. — Прим. перев. 
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Множественные шаблоны документов 


МО!-приложение способно поддерживать множественные шаблоны документов 
при помощи нескольких вызовов Адарос1етр ие. Каждый шаблон может задавать 
другую комбинацию классов «документ», «вид» и «дочерняя МП1-рамка». При вы- 
зове команды Меу из меню Ее каркас приложений выводит на экран список, 
позволяющий выбрать шаблон по имени, заданному в строковом ресурсе (под- 
строка типа документа). В $ОГ-приложении множественные вызовы АдаросТетрще 
не поддерживаются, так как объекты «документ», «вид» и «рамка» создаются толь- 
ко раз за все время жизни приложения. 
ен 
Примечание При выполнении программы объект «приложение» ведет список 
объектов — активных шаблонов документов. «Проходить» по этому списку 
позволяют функции-члены СейияДосТетр/иеРояноп и Сей\ехосТет- 
Риме класса Старр. Вместе с функциями Сей осРозйют и СейУехШос ` 
класса СросТетр ие, перечисляющими документы шаблона, они обес- 


печивают доступ ко всем объектам-документам в приложении. 
дц 


Если список имен шаблонов вас не устраивает, отредактируйте меню Ее, до- 
бавив отдельные команды М№е\ для каждого типа документа. Закодируйте обра- 
ботчики командных сообщений, как показано ниже, используя подстроку типа 
документа из каждого шаблона: 


019 СМуАрр: :ОпЕ11емемфидептт() 
ОрепМембоситеп* ( "Зфидпе”) 
рек СМуАрр: : ОпР11еМ№емТеаснег( ) 
| ОрепМ№емОоситеп* ( "Теаспг”); 

} 


Затем добавьге вспомогательную функцию Ореп№Мешоситете 


ВООГ СМуАрр: :ОрепМембоситепт (сопзт С51г1п9& зЕгТагдет) 
{ 
С$1г1пд9 з1гОосМапте; 
СБосТетр1афе* рзе1естедТетр1ате; 
РОЗТТТОМ роз = веЕР1гз+БосТетр1аферРоз1410оп(): 
мй11е (роз != МЕ) { 
р5е1еседТетр1ате = (СБосТетр1ате») бетМех{ОосТетр1а{е(роз); 
АЗЗЕВТ (рзе1естедТетр1аже != МЕ); 
АЗЗЕВТ ( р5е1естедТетр1ате->1$К1па0т( 
ВУМТТМЕ_СТАЗ$ ( СБосТетр1ате))): 
рбе1естедТетр1ате->бе{бос51г1пд( зЕгОосМаме, 
СБосТетр1ате: :ЧосМаме):; 
11 (31гОосМате == $4гТагде{) { // из строкового ресурса шаблона 
р5е1естедТетр1а+е->ОрепбоситепеЕ11е( МЕ); 
гефтигп ТАУЕ 
} 
} 
гетигп РАЕЗЕ; 
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Запуск МО!-программ из \\Мп4ом/$ Ехр/огег 
и операцией @гад-ап4-дгор 


Приложение запускается двойным щелчком значка документа МО!-приложения 
в УЛпао\$ Ехр!огег, если только оно уже не запущено, — иначе в уже работаю- 
щем приложении открывается новое дочернее окно для выбранного документа. 
Для такого поведения надо вызвать Е па е5реПОретп в функции Ппитпяапсе класса 
приложения. Операция @газ-ап4-4гор работает примерно так же, как и в $П!-про- 
граммах. Если перетащить файл из Ехр!огег в основное окно-рамку МПТ, программа 
откроет новое дочернее окно-рамку (с соответствующим документом и окном 
представления) — точно так же, как и по команде Ореп меню Ее. Как и в $01- 
программах, расширение имен файлов указывается на странице Роситепи Тетрие 
51125 мастера МЕС АррИсайоп УЛ2аг4. 


Пример Ех16Ь: МО!-приложение 


Этот пример — МП1-версия программы Ех16а. В ней точно такой же код классов 
«документ» и «вид» и те же ресурсы (кроме имени программы). Однако код клас- 
сов приложения и основного окна-рамки изменился. Ниже приведен лишь новый 
код, включая сгенерированный мастером МЕС АррИсаНоп У/Лгага. Список файлов 
и классов в проекте Ех16Ь приведен в табл. 16-3. 


Табл. 16-3. Файлы и классы программы Ех16Ь 


Заголовоч- Файл исход- 
ный файл ного кода Класс Описание 
Ех1бЬ.В Ех16Ь.срр СЕХ16ЬАРР Класс приложения (создан МЕС 

АррИсайоп \У/Л2ага) 

САБОИИУв Диалоговое окно АБош 

МашЕгт.В МашЕгт.срр СМатЕгате — Основное окно-рамка МП!-программы 
СВЙаЕгт.В СрйаЕгт.срр СсрияЕгате Дочернее окно-рамка МО!-программы 
СЕх16ЬРосв  СЕх16ЬРоссрр  СЕх16ЬОос Документ с данными о студенте 

(из Ех16а) 


СЕх1бЬ\е\в Ех1бЬ\е\усрр  СЕх16ЬИеш Представление информации 
о студенте (из Ех16а) 


Зкааеп.В Зи4аепесрр суше Запись о студенте (из Ех1ба) 


УкААЕХ.В У%ААЁх.срр Предкомпилированные заголовочные 
файлы (с добавлением аёхетр/.В) 


СЕх16ЬАрр 


В листинге исходного кода СЕх16БАрр функция-член Орепроситешйе переопре- 
делена исключительно для вставки операторов ТКАСЕЁ. Кроме того, добавлено не- 
сколько строк перед вызовом Ргосе555бейСоттата в [пиШпяатсе. В них проверя- 
ется аргумент для Ргосе5рейСоттапа, и при необходимости он изменяется, чтобы 
предотвратить автоматическое создание окна пустого документа при запуске 
программы. 
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см. след. стр. 
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СМатЕгате 


Этот класс основного окна-рамки сходен с $П1-версией, однако его базовым клас- 
сом является СМЫЁгате\та, а не СЕгате\па. 


см. след. стр. 
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А дедов ль сд о РИВА ИИ 
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376 Часть ! Архитектура «документ-вид» в МЕС 


ССПИаЕгате 


Этот класс дочернего окна-рамки позволяет легко управлять характеристиками 
этого окна, изменяя код функции РгеСтеще\"тао. Кроме того, вы можете созда- 
вать обработчики сообщений и переопределять другие виртуальные функции. 
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Тестирование приложения Ех16Ъ 


Соберите программу, запустите ее из \15а1 С++ МЕТ и создайте несколько доку- 
ментов. Попробуйте сохранить документы на диске, закрыть их и снова открыть. 
Проверьте также работу команды М№е\м УЛпао\ из меню УЛадоуу. Заметьге: теперь 
с одним документом связаны два окна представления и два дочерних окна-рам- 
ки. Завершите программу и откройте окно УЛпао\мз Ехргег. Рядом с именами 
созданных вами файлов должен отображаться значок документа. Дважды щелк- 
ните его и посмотрите, запустится ли Ех16Ъ. Затем, запустив Ехрогег и Ех16Ь, 
перетащите документ из проводника в Ех16Ь. Открыла ли программа файл? 
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Работа с документами в МТ!-приложениях 


В УЛпао\$ 2000 появился третий тип приложения: программа с множественны- 
ми интерфейсами верхнего уровня (Мшир!е Тор-Геуе! ииегЁасе, МТУ). Он приме- 
няется в Мсгозой ОЁйсе 2000 и М1сгозой ОЁйсе ХР. МТ!-приложения похожи на $0]- 
приложения, но каждая $П]1-программа выполняется в отдельном окне, а в МТГодин 
экземпляр приложения обслуживает все открытые окна. Когда пользователь со- 
здает новый файл, приложение открывает новое независимое окно верхнего уровня 
и соответствующие ему новый документ, но они закреплены за тем же экземпля- 
ром исполняемого приложения. 


Пример Ех16с: МТ|-приложение 


Ех16с — это МТ!-версия программы Ех16ба. При создании этого примера в масте- 
ре МЕС АррИсайоп УЛгага на странице АррИсаноп Туре нужно установить пере- 
ключатель в положение Мшир!е Тор-Геуе! Росштеп($, сбросить флажок РипИпе 
Апа Рипе Ргеме\ на странице А4уапсеа Ееагаге$ и на странице Сепегаие С!а$5е5 
выбрать в качестве базового класс СЕоттИе. 

В Ех16с использует тот же код классов документа и представления и те же 
ресурсы (кроме имен). Однако прикладной код и код класса основного окна-рамки 
другие. Код приложения Ех16с вы найдете на компакт-диске. Список файлов и 
классов в Ех16с примере показан в табл. 16-4. 


Табл. 16-4. Файлы и классы примера Ех16с 


Е 
Заголовоч- Файл с исход- 


ный файл ным кодом Класс Описание 
Ех16с.В Ех16с.срр СЕх16сАрр Класс приложения (создан МЕС 
АррИсайоп УЛлага) 
САБОИИУ Диалоговое окно АБош 
МашЕгт.В МашЕгт.срр СМатЕтате Основное окно-рамка МТ!-приложения 
СЕх16сРось  СЕх16сроссрр  СЕх16срос Документ с данными о студенте 
(из Ех1ба) 


СЕх1бс\е\Ь  Ех16бс\Уе\у’срр СЕх1бс\еш Представление информации 
о студенте (из Ех16а) 


Зааепе.В Зиаепесрр сушает Запись о студенте (из Ех16ба) 


ЗААЁх.В ЗЧАЁХ.срр Предкомпилированные заголовочные 
файлы (с добавлением аёиетр!.В) 


В отличие от МП]- и $П1-приложений, МТ!-приложение содержит в меню ЕНе 
команду М№еуу Егате. Она заставляет приложение открывать новое окно верхнего 
уровня. В листинге показана обработка команды Ме\ Егате. 


\019 СЕх1бсАрр: : ОпР11еМемЕгате( ) 

{ 
АЗУЕВТ (п_рбосТетр1афе != МЕ); 
СБоситеп{* рос. = МЕ; 
СЕгатемпа* рЕгате = МИ; 


// Создаем новый экземпляр документа, на который 
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—Щ—Ш—ШШ——до——»»=—_—_—_—_.„—- 


// ссылается переменная-член м_рбосТетр1ате. 
р0ос = м_рбосТетр1ате->СгеатемемВоситеп* ( ) 
Те (р0ос != МЕ) 
{ 
// В случае успеха создания создаем новое окно-рамку’ для документа 
рЕгате = м_рбосТетр1а{е->СгеатеМемЕгате(рбос, МЕ) 
17 (рЕгате != МЕ) 
{ 
// Задаем заголовок и инициализируем документ. 
// В случае сбоя инициализации документа, 
// удаляем окно-рамку и документ. 


п_рОосТетр1ате->5е{0егаи1+Т111е(р0ос); 
1Р (!рбос->Опм№ембоситеп*()) 
{ 
рЕгате->Везтгоум1пдом(); 
рЕгате = МЕ; 
} 
е1зе 


{ 
// В противном случае обновляем окно-рамку 
п_рбосТемр1ате->Тп1{1а1ИрдатеЕгаме(рЕгаме, р0ос, ТВУЕ) 


// В случае неудачи удаляем документ и 
// выводим информационное окно для пользователя. 
1 (рЕгате == МИЦ +1! рдос == МУ) 
{ 
де1ете р0ос; 
АГхМеззадеВох (АРХ_ТОР_ЕАТЕЕО_ТО_СВЕАТЕ_00С); 


Для управления документом, окном-рамкой и представлением в МТ!-приложе- 
ниях применяется класс СМийРос1етриае. Заметьте: ОпЕйеМешЕтате самостоятель- 
но создает новый документ и новое окно-рамку верхнего уровня, не полагаясь на 
каркас приложения для создания документа, окна-рамки и классов представления. 
В остальном МТ!-приложения управляют своими документами и представления- 
ми так же, как и $01- и МО!-приложения. 


Тестирование приложения Ех16с 


Запустите приложение Ех16с и выберите команду Ме\/ Егате в меню ЕЙе. Заметь- 
те, что новое окно-рамка находится рядом с существующим. Новое окно-рамка 
верхнего уровня содержит новый экземпляр документа, но документ связан с новым 
окном-рамкой (а не с новым дочерним окном-рамкой МГПУ, как в Ех16Ь). 


ГЛАВА 


17 


Печать и предварительный 
просмотр 


Вен вы полагаетесь только на \/1п32 АРТ, программирование печати станет для 
вас мукой. К счастью, каркас приложений библиотеки МЕС существенно упроща- 
ет эту задачу. В нем также предусмотрена функция предварительного просмотра 
документов перед распечаткой, которая выполняет те же задачи, что и аналогич- 
ные функции в коммерческих УЛп49о\5-программах, таких как М!сгозой ога или 
Мисгозой Ехсе|. 

В этой главе вы узнаете, как использовать МЕС-функции печати и предвари- 
тельного просмотра. Попутно вы получите представление о том, что происходит 
в УЛп9о\$ в процессе печати и чем этот процесс отличается от печати в М5-2О$. 
Сначала вы познакомитесь с программированием печати в режиме У/УЗГУ/УС, при 
котором принтерная распечатка практически идентична экранному изображению. 
Этот вариант требует аккуратного обращения с режимами преобразования коор- 
динат в У/Лп4о\5. Потом мы объясним, как напечатать многостраничный отчет, 
выглядящий на бумаге совершенно не так, как на экране; кроме того, используя 
шаблон массива, вы структурируете свой документ так, чтобы программа смогла 
по требованию печатать любой заданный диапазон страниц. 


Печать в \Итдо\$ 


Прежде программистам приходилось заботиться о настройке своих приложений 
для самых разных принтеров. Теперь об этом заботится УЛпо\уз, в которой есть 
драйверы чуть ли не для всех принтеров. Кроме того, она обеспечивает единый 
пользовательский интерфейс для задач, связанных с печатью. 
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Стандартные диалоговые окна печати 


Когда в УЛп9о\з-приложении выбирают команду Риши( из меню ЕЦе, на экране 
появляется стандартное диалоговое окно Ри!пе (рис. 17-1). 


рее 


Рис. 17-1. Стандартное диалоговое окно РИ 


А если в диалоговом окне Ришпе щелкнуть кнопку Ргорегие$, откроется окно 
Роситеп: Ргорегие$ (рис. 17-2). 


РореНЦеь 


Рис. 17-2. Диалоговое окно Роситет! РгоретИе$ 


В процессе печати программа выводит стандартное диалоговое окно с инфор- 
мацией о состоянии принтера‘. 


' Не совсем так — это окно отображается при пересылке данных в службу печати (спу- 
лер), а не на весь период (обычно более длительный) собственно печати файла на 
принтере. — Прим. перев. 
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Интерактивный выбор страниц для печати 


Если вы занимались обработкой данных, то, наверное, привыкли к пакетному 
режиму печати. Программа считывает запись, форматирует ее и печатает выбран- 
ную информацию как строку в отчете. После распечатки, скажем, 50 строк, про- 
грамма заставляет принтер вытолкнуть лист бумаги и начать печатать новую стра- 
ницу. В таких случаях обычно полагают, что отчет печатается целиком, и не пре- 
дусматривают возможности выбора страниц в интерактивном режиме. 

Но при печати в \Лп4о\5 разбиение на страницы играет большую роль 
(рис. 17-1). Программа должна реагировать на выбор страниц пользователем, 
вычисляя, какую именно информацию напечатать, поэтому вы должны соответ- 
ственно структурировать данные в своем приложении. 

Помните список студентов из главы 16? Что, если в нем окажется 1000 студен- 
тов и пользователю понадобится 5-я страница отчета? Допустим, запись о студенте 
укладывается в одну строку, а на одной странице умещается 50 строк. Тогда на пятой 
странице должны быть строки с 201 по 250. Если вы используете МЕС-класс списка, 
вам придется, прежде чем приступить к печати, «пролистать» первые 200 элемен- 
тов списка. Понятно, что в данной ситуации список — далеко не идеальная струк- 
тура. А если вместо него применить массив? Класс СОБАттау (или один из клас- 
сов-шаблонов массива) позволит обратиться прямо к 201-й записи о студенте. 

Отнюдь не в каждом приложении переменные-члены жестко связаны с опре- 
деленным числом печатных строк. Представьте, что в записи о студенте есть поле 
«биография» в несколько печатных строк. Так как заранее неизвестно, сколько строк 
занимает биография конкретного студента, придется просматривать весь файл, 
чтобы определить границы страниц. Но ваша программа станет работать гораз- 
до эффективнее, если сможет «запоминать» эти границы по мере их вычисления. 


Экранные и печатные страницы 


Часто желательно, чтобы отпечатанная страница соответствовала изображению 
на экране. Гарантировать этого нельзя. Однако шрифты ТгаеТуре позволяют до- 
биться близкого соответствия. Если вы работаете с полноразмерными листами бу- 
маги, окно должно быть больше размера экрана. Поэтому для просмотра печата- 
емых изображений идеально подходит класс С5сто\еи». 

Впрочем, иногда об экранных страницах можно не заботиться. Скажем, ваш 
класс «вид» хранит данные в каком-то окне списка, или их вообще не надо выво- 
дить на экран. В таких случаях в программу обычно закладывают логику «авто- 
номной» печати, при которой данные просто извлекаются из документа и отсы- 
лаются на принтер. Конечно, программа должна корректно обрабатывать запрос 
пользователя на печать не всего документа, а лишь какого-то диапазона страниц. 
Запросив у драйвера принтера размер бумаги и ориентацию листов (книжная или 
альбомная), вы сможете корректировать разбиение документа на страницы. 


Предварительный просмотр перед печатью 


Предварительный просмотр перед печатью (рипе ргеуех), поддерживаемый МЕС- 
библиотекой, позволяет увидеть на экране границы страниц и концы строк точ- 
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но в тех местах, где они получатся при распечатке документа на выбранном прин- 
тере. Шрифт, особенно мелкий, может выглядеть несколько странно, но это не 
проблема. 

Предварительный просмотр перед печатью поддерживает библиотека МЕС, а 
не УЛюао\5. Реализация поддержки потребовала от разработчиков библиотеки 
колоссальных усилий. Эта функция анализирует каждый символ, определяя его 
позицию на основе контекста принтера. Подобрав более-менее подходящий шрифт, 
она выводит символ в окно предварительного просмотра. 


Программирование вывода на печать 


Каркас приложений берет на себя большую часть работы по поддержке печати и 
предварительного просмотра. Чтобы эффективно использовать принтер, надо знать 
порядок вызовов функций и понимать, какие из них и когда переопределять. 


Контекст принтера и функция СИеи/::ОпОгаи 


При печати на принтере программа использует объект «контекст устройства» класса 
СОС. Не беспокойтесь о том, откуда возьмется этот объект, — его создает каркас 
приложений, передавая затем как параметр в функцию Оита вашего класса «вид». 
Если программа просто копирует содержимое экрана на принтер, Опргаи может 
выполнять две задачи. При выводе на экран ОпРайй вызывает Оп)гаи», передавая 
ей контекст дисплея, а при печати ОпРуйи другая виртуальная функция класса СИеш 
вызывает Оп)таи», передавая ей контекст принтера. Один вызов функции ОпРГЙЁ 
позволяет отпечатать одну страницу целиком. 

В режиме предварительного просмотра параметр функции Оп)таш служит 
указателем на объект «контекст устройства» класса СРгеешрОс. Функции ОпР’й{ 
и Оп)гаи работают одинаково независимо от того, печатаете вы или просматри- 
ваете документ перед печатью. 


Функция СИУеи::ОпРИТ 


Вы уже убедились, что функция ОпРи#и# (базового класса) вызывает Опбтаи и что 
та способна использовать контекст как дисплея, так и принтера. Перед вызовом 
ОпРгий нужно установить режим преобразования координат. Чтобы печатать эле- 
менты, которые не обязательно показывать на экране (скажем, титульную стра- 
ницу, верхние и нижние колонтитулы), функцию ОиРии! можно переопределить. 
Она получает два указателя: на контекст устройства и на структуру СРитИи), где 
хранятся размеры страницы, номер текущей страницы и максимальный номер 
страницы. 

Переопределяя функцию ОпРийф, можно вообще не вызывать Оита, когда 
логика печати полностью независима от логики вывода на экран. Для каждой 
печатаемой страницы каркас приложений вызывает ОпйР’Й! по одному разу — с 
указанием ее номера в структуре СРитИйр. 
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Подготовка контекста устройства: функция 
СМеи::ОпРгерагерС 


Если вам нужен режим преобразования координат на экране, отличный от ММ _ТЕХТ 
(а так оно обычно и бывает), лучше установить его в функции ОпРгерагерсС клас- 
са «вид». Вы сами переопределяете эту функцию, если ваш класс «вид» наследует 
напрямую классу СИеш, но, если он является производным С5стоШИеи», функция 
уже переопределена. ОпРа! вызывает ОпРгератерсС прямо перед вызовом ОпОгаи. 
Если же вы печатаете на принтере, обращение к ОиРгерагерС выполняется перед 
тем, как каркас приложений вызывает ОпРийи. Так что программа устанавливает 
режим преобразования координат и перед прорисовкой экранного изображения, 
и перед печатью страницы. 

Второй параметр функции ОпРгератерсС — указатель на структуру СРгтИпЮ. Он 
действителен, только если ОиРгератерсС вызывается до печати. Проверяет его до- 
стоверность функция-член СОС::[5Римиив. Она особенно удобна, если через ОиРуе- 
ратеОС вы устанавливаете на экране и на принтере разные режимы преобразова- 
ния координат. 

Если вы заранее не знаете, сколько страниц придется печатать, переопреде- 
лите функцию ОпРгератерС так, чтобы она отыскивала конец документа и сбра- 
сывала флажок 71_ВСопипиеРутитв в структуре СРитИи)о. Если этот флажок ра- 
вен Р4/5Е, функция ОпРийй не вызывается, а управление передается в конец цик- 
ла печати. 


Начало и конец печати 


Когда начинается процесс печати, каркас приложений вызывает две функции класса 
С\еш — ОпРгератеРттиив и ОпВезтРититв. Первая вызывается перед открыти- 
ем диалогового окна Рипе. (При установленном флажке РипИпе апа Рип Ргеме\у 
мастер МЕС АррИисацоп УЛгага генерирует функции ОпРгератеР"типв, ОпВевт- 
Рипит8 и ОпЕпаРгтипв.) Функция ОпРгератеРитипив вызывается перед отображе- 
нием окна Рипг. Если вам известно минимальное и максимальное число страниц, 
вызовите из ОпРгератеРутипв функции СРитИп/о::5еМтРаве и СРитИп}о::$е1- 
МахРаве. Числа, которые вы передаете этим функциям, появятся в диалоговом окне 
Рипь, и пользователь сможет изменить их. 

Функция ОпВевтРитиив вызывается после закрытия диалогового окна Риге, Она 
переопределяется для создания СО]-объектов, например, необходимых для печа- 
ти шрифтов. Программа будет работать быстрее, если создать шрифт заранее, а 
не повторять эту операцию для каждой страницы. 

Функция СИеш::ОпЕпаРитипв вызывается в конце печати — после того, как 
отпечатана последняя страница. Ее переопределяют для уничтожения СП]-объектов, 
созданных в ОпВевтРитиив. 

В табл. 17-1 показаны важнейшие для цикла печати функции класса СУеш, 
которые обычно переопределяют. 
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Табл. 17-1. Переопределяемые функции цикла печати в классе СИеи 


Функция Для чего обычно переопределяется 

ОпРгератеРутитв Установка минимального и максимального числа 
страниц 

ОпВевтРипиия Создание СП]-объектов 


ОпРгератерС (для каждой страницы) Установка режима преобразования координат 
и определение момента конца печати 


ОпРий! (для каждой страницы) Выполнение подготовительных операций, связан- 
ных с выводом на печать, и вызов Ой)таи 
ОпПЕПАРГТИПв Удаление СП]-объектов 


Пример Ех17а: печать в режиме ММУ$ЗИМУС 


Эта программа отображает на экране и печатает одну страницу текста. Отпеча- 
танная страница совпадает с изображением на экране. И для принтера, и для дис- 
плея задается режим преобразования координат ММ_Т\Р5. В исходном виде про- 
грамма выводит текст в фиксированную область печати (Ихе4 ргицаЫе агеа 
гессап]е), но потом мы модернизируем ее так, чтобы она подстраивалась к обла- 
сти печати, поддерживаемой драйвером принтера. 

1. В окне МЕС АррИсайоп У/12аг4 создайте Ех17а. Примите параметры по 
умолчанию, но на странице СепегатеЯ С!а$5ез переименуйте классы «вид» С5#9- 
Уеи и «документ» СРоетОос. В качестве базового для С5йтвИеи выберите класс 
С5стоШПеи. Обратите внимание, что создается МР!-приложение. 

2. Добавьте переменную-член типа С5И4игАттау в класс СРоетОос. Отре- 
дактируйте заголовочный файл Роетос.В, добавив строку: 


руб11с: 
С5{г1пдАггау м_3з{г1пдАггау; 


Данные документа хранятся в массиве строк. МЕС-класс СбйизАттау содер- 
жит массив объектов класса (5115, доступных по индексу (нумерация начи- 
нается с 0). Максимальную размерность массива при объявлении указывать не 
надо, потому что он динамический. 

3. Добавьте переменную-член типа СКес| в класс С$И4тИеи». Отредакти- 
руйте заголовочный файл Уи \У1е\Ь, добавив строку: 


рг1\ате: 
СВест м_гесеРг1пт; 


4. Отредактируйте три функции-члена класса СРоетОос в файле Роет- 
Рос.срр. МЕС АррИсайоп \/Лгага создал заготовки функций ОпМешОосите"! 
и 5епайе, но нам придется в окне РгорегИе$ утилиты С!а55 У1е\у переопреде- 
лить также функцию РевеСотет&. Инициализацию документа-«стихотворе- 
ния» мы предусмотрим в переопределенной функции ОпМ№еш)оситет. рееЕ- 
Сотет$ вызывается из СБоситет::ОпМешОоситетй, так что благодаря вызову 
сначала функции базового класса стихотворение не пропадет. [Кстати, это 
фрагмент 20-го стихотворения из книги Лоренса Ферлингетти (Гаулепсе Ее п- 
зпец1) «А Сопеу 1$апа оЁ ше М114.] Если вам не нравится текст — возьмите 
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другое произведение или описание любимой \/1152-функции. Добавьте выде- 
ленный код: 


ВОО СРоетдос: :ОпМембоситеп* () 
{ 
1 (! СБосимеп* : : ОпМембоситеп* ()) 
гефигп РАЕЗЕ 


п_$Ег1пдАггау. 5е1517е(10); 
т_зЕг1поАггау[0] = “Тпе реппусапаузфоге Беуопа +пе Е1"; 


т_$Ег1пдАггау[1] = "1$ мпеге Т 11гз*"; 

м_$Ег1пдАггау[2] = " {е11 1т 10оуе"; 
т_$г1пдАггау[3] = " м1 ипгеа11ту“; 
м_3г1пд9Аггау[4] = “уе11убеапз 910\ме9 1п Не зет1-9100т"; 
т_3{г1пдАггау[5] = “ог 1Ваф зерфетбег аР+егпооп"; 
м_3г1п9Аггау[6] = “А саф ироп {Не соипфег томе атопд”; 
т_3г1пдАггау[7] =" {Пе 11сог1се ${1скз”; 
М_${г1пдАггау[8] =" ап +00+$1е го113”; 
_$Ег1пдАггау[9] = " ап Он Воу бит”; 


гефигп ТВИЕ; 
} 


АВ ана. 
Примечание Класс с5йтвАтгау поддерживает динамические массивы, но здесь 
мы используем объект 7 5йизАггау так, будто это статический массив 
с 10 элементами. 


При закрытии документа каркас приложений вызывает виртуальную фун- 
кцию РеееСотет5 класса документа; при этом строки в массиве удаляются. 
СбттвАттау содержит собственно объекты, а СОБАтта) — указатели на них. 
Важность этого различия станет ясна, когда придет пора удалять элементы 
массива. Функция КетогеАИ уничтожает строковые объекты так: 


\0149 СРоетбос: : Ое1етебСопфептт$() 

{ 
// вызывается перед вызовом Оп\ембоситеп+ и при закрытии документа 
т_3г1поАггау. ВетоуеА11(); 


Сериализация в этом примере не существенна, но приведенная ниже фун- 
кция иллюстрирует, насколько проста эта операция над строками. Каркас при- 
ложений вызывает РеееСотет15 перед загрузкой из архива, так что вам нет 
нужды беспокоиться об очистке массива. Введите выделенный код: 


\0149 СРоет)ос: :5ег1а117е(САгси1\уе& аг) 
{ 

т_3{г1пдАггау. 5ег1а112е(аг); 
} 


5. Отредактируйте функцию ОшимаП/раше в $илпеУ1еуу.срр. Эту функцию 
следует переопределить для всех классов, производных от С5стоИе. Она уста- 


ГЛАВА 17 Печать и предварительный просмотр 387 


навливает логический размер окна и режим преобразования координат. До- 
бавьте выделенный код: 


№019 СЭЕг1па\1ем: :ОпТи1{1а10рдате() 


{ 


} 


С$сго11\М1ем: :Оп1п1{1а10рдате(); 
(С$12е 317еТота1 (м_гесЕРг1пт.И1аеи(), -м_гесЕРг1и{.Не19*()); 
С$12е з312еРаде(312еТо\а1.сх / 2, 

312еТота1.су / 2); // прокрутка страницы 
С$17е 312е11пе(317еТофа1.сх / 100, 

317еТо1а1.су / 100); // прокрутка строки 
3е15сго11$12ез(ММ_ТМТР$, 317еТофа1, 31хеРаде, $12е11пе); 


Отредактируйте функцию Оп)гаи в $&1т2У1е\.срр. Функция Опргаш 
класса СЗтеШеи выводит изображение и на экран, и на принтер. Она не только 
показывает строки стихотворения шрифтом Титез Ме\у Вотап (размером 10 пт), 
но и очерчивает область печати и формирует какое-то подобие линеек по 
верхнему и левому полям. Функция предполагает применение режима ММ_ТР5, 
при котором 1 дюйм равен 1440 единицам. Добавьте выделенный код: 


\014 СЗЕг1па\1ем: :Опбгам(С9С* рос) 


{ 


11 1, }, пНезоит; 
С51г11п9  З1Г; 
СРопе опт; 
ТЕХТМЕТВТС 1п; 


СРоетбос* р0ос = бетбоситеп*(); 
// Рисуем рамку - чуть меньше, чтобы избежать отсечения 
роС->Весфапд1е(т_гесЕРг1пЕ + СВес*(0, 0, -20, 20)); 
// Рисуем вертикальную и горизонтальную линейки 
3 = м гесеРг1п*. МЗ () / 1440; 
Рог (1=0; 1 <=}; 1++) { 
эЕг. Рогта* ( "#024", 1); 
роС->ТехЕ0и{(1 * 1440, 0, з+г); 
} 
] = -(м_гесЕРг1ип{. Не19и*() / 1440); 
Тог. (1 = 0: НЫ 
эЁг. Рогмат( "Х029", 1); 
роС->ТехЕ0и{(0, -1 * 1440, з1г); 
} 
// напечатать текст на полдюйма ниже и правее... 
// шрифтом Т1тез № м Вотап, 10 пунктов 
Топф. СгеатеРоп*(-200, 0, 0, 0, 400, РАЁЗЕ, 
РАЕЗЕ, 0, АМЗТ_СНАВЗЕТ, 
О0ЦТ_БЕРАУЕТ_РВЕСТ$, СЕТР_ОЕРАЦЕТ_РВЕСТ$, 
ОЕРАЦЕТ_ОУАЕТТУ, ОЕРАЦЕТ_РТТСН : ЕР_ВОМАМ, 
"Т1тез №м Нотап”); 
СРопе* р0149Ропф = (СРопе*) р0С->5е1ес+06 ест ( &Роп{); 
рОС->бе{ТехМетг1с$(&1т); 
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пНе19Н{ = {т. +Незопе + 1м. ттЕхфегпа11еа91п0; 
ТВАСЕ("Топ{ пе19п = %4, 1пфегпа1 1еа41пд = %4\п", 
пНе19й{, тм. {тТпфегпа11еа91п9); 
] = р0ос->м_$+г1пдАггау. бет$17е(); 
Рог (1=0; 1<]; 1++) { 
роС->ТехЕ0и{(720, -1 * пНе1дпе - 720, 
рбос->т_3з1г1пдАггау[1]); 
} 
роС->$е1ес+06}ес+(р019Роп*); 
ТВАСЕ( "ГОСРТХЕЕЗХ = %4, ЕОбРТХЕТЗУ = %а\п" 
роС->бетдеу1сеСарз(ГОбРТХЕЕЗХ), 
роС->бетВеу1сеСарз(ЕОбРТХЕЕ$У)); 
ТВАСЕ( "НОВУЗТ7Е = $4, УЕАТЗТЕЕ = %а\п”, 
рОС->бетбеу1сеСарз(НОВ75Т7Е), 
роС->бетдеу1сеСарз(МЕАТ$Т7Е)); 
} 


7. Отредактируйте функцию ОнРгерагеРтийиз в $1 У1еу.срр. Она уста- 
навливает максимальное число печатаемых страниц. В нашем примере печа- 
тается только одна страница. В переопределенной функции ОпРгерагеРитиив 
надо обязательно вызвать функцию РоРуерагеРнииив базового класса. Введи- 
те выделенный код: 


ВО0Е С$Ег1пд\1ем: :ОпРгерагеРг1п1пд (СРг1иЕТпРо» рТпРо) 
{ 

рТпто->5е1МахРаде(1); 

гефигп_ ОбоРгерагеРг1п{1пд(рТпто); 


} 


8. Отредактируйте конструктор в $и1пеМеу.срр. Начальная область печати 
должна составлять 8Х15 дюймов и выражаться в твипах (1 дюйм = 1440 твипов). 
Добавьте выделенный код: 


СЗЕг1поМ1ем: :С$г1по\узем() : т_гесЕРг1п(0, 0, 11520, -21600){ 
} 


9. Соберите и протестируйте приложение. Если запустить приложение Ех17а 
под УЛпаоууз МТ/2000/ХР с низким экранным разрешением, дочернее МГ!-окно 
должно выглядеть, как рисунке. (При более высоком разрешении или под Х/т- 
40%; 95/98 текст кажется более крупным.) 

Текст мелковат, правда? Пойдем дальше: выберем из меню ЕйЙе пункт Рип: 
Ргеу1с\ и увеличим изображение, дважды щелкнув «лупу». Резульгат показан на 
следующей странице. 

Помните «логические твипы» из главы 6? Сейчас мы попробуем с их помо- 
щью увеличить изображение на дисплее, не меняя его размер при печати. Это 
требует дополнительных усилий, так как класс’ Сбсто/еи не рассчитан на 
нестандартные режимы преобразования координат. Придется заменить базо- 
вый класс представления: вместо СустоИеи взять СТовстоИеи, который один 
из авторов создал, изменив исходный МЕС-код в У1е\у5си.срр. Файлы Гов$сго!- 
Уе\з/В и ГовсгоИ\еуусрр находятся в каталоге \усррпе(\ Ех17а на компакт- 
диске. 
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Тре репиусанйуйоте Ъеуона в Е 
Бзибате 1 бя: 
вое 
эВ лова 
За уфеаля дона в Ча зенц- оо 
оЕАрай зерренфег аЙетоон, 
А сы пром Ва сошег иноуей анона: 
ра Бсомсе Нея 
ай досье го 
зы ОВ Воу бши 


Те реппусвидуя те 6еусп Пе Е1 
18 муреге 1 бт 
121 ш юуе 


мВ ме Ву 
Зе Цубезлз 1очге4 п 1Ве зепи- оо 
оР\ра зеретбег аЙйетоой 
А са! дроп ве сомиёег поуед апойй 
Бе Псойсе эс! 
вп фоовие гоП5 
з04 ОБ Воу Суми 


10. Вставьте класс СГоз5сгоПИеи в проект. Скопируйте файлы Говзсго!\е\,.В 
и Говбсго|!\е\усрр с компакт-диска (если не сделали этого раньше). В меню 
Ргодеси выберите Ааа Ех15Ипз Цет, а затем в открывшемся окне выберите ско- 
пированные файлы и щелкните ОК, чтобы внести их в проект. 


11. Отредактируйте заголовочный файл $1прУ1е\.В. Добавьте в начало файла: 
#1пс1иде “Ёо95сго11 лем. п” 
Затем замените строку: 
С1а$$ С5{г1па\1ем : риб11с С5сго11\1ем 


на: 


14—2064 
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с1а$$ С5%г1пд\1ем : риб11с С109$сго11\У1ем 


12. Отредактируйте файл $1пеУ1е\у.срр. Повсеместно замените все вхожде- 
ния СстоШЙеи на СГовустоТеи. Затем отредактируйте функцию ОпйийаЮрааее. 
Отредактированный код намного короче: 


\014 СЗ+г1пд\Тем: :ОпТп1{1а10рда*е() 

{ 
С109$сго11 М1 ем: :Оп1Тп1{1а10рдате(); 
(512е $127еТофа1(т_гесЕРг1п{. Мзаен(), -т_гесРг1ие.Незопт()); 
5е11095$сго11$17е3($12еТот\а1); 

} 


15. Снова соберите и протестируйте приложение. Теперь на экране должно 
быть нечто вроде: 


Тре реппусапдуяоте беуоп4 ве Е! 
18 уБеге 1 без! 
Зе 4 |оуе 
ийь дихеаВ у 
ейубеалз доче за Ве зенц- ост 
оР\Ва зербеньег «йетоо 


А сагароп {Ве соцафег моуед атопё 
Че Нсойсе ска 


ап фооые 105 
ап ОБ Воу Сми, 


Определение области печати 


Ех17а печатает в фиксированной области, соответствующей настройке лазерно- 
го принтера для печати в книжной ориентации на листах размером 8,5х11 дюй- 
мов (формат Гецег). А если вы загрузили бумагу формата А4 или выбрали альбомную 
ориентацию? Программа должна уметь подстраиваться под новые параметры. 

Определить область печати принтера сравнительно несложно. Помните ука- 
затель на структуру СРитИиро, передаваемый в ОиРит В этой структуре есть поле 
т_тесташ, в котором хранятся логические координаты области печати. К ней и 
обращается функция Оп)тгаш. Правда, определить эту область, пока не начнется 
печать, нельзя, поэтому надо установить для Опртаи какую-то область по умол- 
чанию, чтобы использовать ее до начала печати. 

Если вы хотите, чтобы Ех17а определяла область печати принтера, переопре- 
делите ОпРий! в окне Ргорегие$ утилиты С!а55 У1е\, а затем напишите ее код: 


\019 С$г1па\1ем: :ОпРг1пт(С0С* рОб, СРг1пТпРо»* рТпто) 
{ 
п_гесЕРг1пЕ = рТпРо->т_гесЕОгам; 
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$е11095сго11$17е3(С$17е(т_гесфРг1п*. Иан), 
-п_гесЕРг1п*. Не19в*())); 
СЕо95сго11 Тем: :ОпРг1п(рОС, рТиРо); 


Еще раз о классах-шаблонах наборов: класс САгау 


В программе Ех15Ь (см. главу 15) мы работали с СТуреяРи!151 — классом-шабло- 
ном набора из МЕС-библиотеки, в котором мы хранили список указателей на 
объекты С5иает. Другой такой класс, САттау, пригодится для примера Ех17Ь. Он 
отличается от СТуреаРи!4 по двум позициям. Во-первых, как и СЗиирАтга) в Ех17а, 
это массив с элементами, доступными по индексу. Во-вторых, он хранит не ука- 
затели на объекты, а сами объекты. В программе Ех17Ь элементы массива — это 
объекты класса СКест. Класс элемента не должен быть производным от СОБесь, а 
в случае с СКес{ это как раз так. 
Как ив Ех15Ь, оператор руреде/ упрощает работу с шаблоном. Мы напишем: 


Туреде{г САггау<СВест, СНест&> СВесфАггау; 


и определим тем самым класс массива, содержащий объекты СКесф, ссылки на 
которые будут принимать функции этого класса. (Передавать 32-разрядные ука- 
затели эффективнее, чем копировать 128-разрядные объекты.) Чтобы использо- 
вать шаблон массива, надо объявить экземпляр класса СКесттау, а затем вызвать 
функции-члены класса САггау, например $е5е. Кроме того, для доступа к элемен- 
там этого массива можно применить оператор [] класса СА’тау. 

Классы-шаблоны СА’тау, СИ и СМар просты в обращении, если прост класс 
элементов. Класс СКес! удовлетворяет этому условию, так как не содержит указа- 
телей. Для сериализации всех элементов в наборе каждый класс-шаблон вызыва- 
ет глобальную функцию 5епайзе етет5, предлагаемую по умолчанию, которая 
осуществляет побитовое копирование объекта в архив и из архива. 

Если ваш класс элементов содержит указатели или что-то еще, усложняющее 
его, придется написать свою функцию 5еайзе етети5. Скажем, для массива пря- 
моугольников эта функция выглядела бы так (на самом деле это не нужно): 


\0149 АРХАРТ 5ег1а117еЕ1етеп{$(САгсп1\е& аг, СВест* р№емВесф$, 1п пСоипт) 
{ 
Рог (1111 = 0; 1 < пСоип{: 1++, р№емВест$++) { 
17 (аг. 1$5%0г119()) {< 
аг << *«р№емВестз 
} 
е15е { 
аг >> *р№емВест$; 


Обнаружив эту функцию, компилятор использует ее вместо 5епайзе ететиь, 
определенной в шаблоне, но только если прототип функции 5епайге етет!5 указан 
до объявления класса шаблона. 
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ААА ИАА АИИС АКА 
Примечание Классы-шаблоны зависят и от двух других глобальных функций: 


Сопятисететв и Реятисететия. С У15иа| С++ 4.0 эти функции вызы- 
вают для каждого объекта конструктор и деструктор класса элементов, 
так что заменять их не надо. 


Пример Ех17Ь: программа печати многих страниц 


В этом примере документ содержит массив из 50 объектов СКес!, описывающих 
окружности, которые случайным образом разбросаны в прямоугольной области 
6х6 дюймов и имеют произвольные диаметры (не менее полдюйма) — получает- 
ся нечто напоминающее мыльные пузыри. В то же время программа выводит на 
принтер не сами окружности, а координаты соответствующих им объектов СКес! 

в числовой форме — по 12 на каждой странице с колонтитулами. 

1. Средствами МЕС АррНсаНоп У/таг4 создайте проект Ех17Ь. Примите 
параметры по умолчанию, но на странице АррИсаНоп Туре мастера установи- 
те переключатель в положение Зее аоситепи. 

2. Отредактируйте заголовочный файл $1ААЁх.В. Добавьте объявление клас- 
сов-шаблонов наборов МЕС. Для этого вставьте строку: 


#1пс1иде <аРхфетр1.п> 


3. Отредактируйте заголовочный файл Ех17ЬОос.5. В примере Ех174 дан- 
ные документа состояли из строк, хранившихся в наборе С57твАттау. Поскольку 
мы используем шаблон набора для прямоугольников, ограничивающих эллипсы, 
нам нужен оператор руреаде] (вне объявления класса): 


Туредег САггау<СВест, СВес{&> СВестАггау; 
Теперь объявите в Ех17БДРос.В открытые переменные-члены: 


руб] 1с: 
епит { п пезРегРаде = 12 }; 
епит { пМахЕ111рзез = 50 }; 
СВестАггау м_е111рзеАггау; 


Операторы перечисления — «объектно-ориентированные» заменители опера- 
торов #а4ейте. 

4. Отредактируйте файл реализации Ех17Бос.срр. Переопределенная фун- 
кция Ой\МеиРоситет инициализирует массив эллипсов произвольными зна- 
чениями, а функция 5епайзе считывает и записывает весь массив. Заготовку этих 
функций генерирует МЕС АррИсацоп УЛага. Функция РевеСотет5 не нуж- 
на, потому что оператор [] класса СА’тау записывает новый объект СКесё вме- 
сто существующего. Добавьте выделенный код: 


ВООЕ СЕх17Ьос : :ОпМемОоситеп* () 
{ 
11 (!СОоситеп*: : Оп№ембоситеп* ()) 
гефигп РАЕЗЕ 


11 п1, п2, п3; 
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// Создаем 50 произвольных окружностей 
згапд( (ипз19пеа) +1те(мМиЕ)); 
п_е111рзеАггау. 5е1517е(пМахЕ111рзез); 


Рог (111 1=0; 1 < пМахЕ111рзез; 1++) { 

п1 = гапд() * 600 / ВАМО_МАХ; 

п2 = гапд() * 600 / ВАМО_МАХ; 

п3 = гапд() * 50 / ВАМО_МАХ; 

п_е111рзеАггау[1] = СВесе(п1, -п2, п1 + п3, -(п2 + п3)); 
} 


гефигп ТВОЕ; 
} 


№014 СЕх1760ос: :5ег1а1127е (САгси1\уе& аг) 


{ 
п_е111рзеАггау. $ег1а117е(аг); 


} 


. Измените заголовочный файл Ех17Б\У1еу.Б. Используя доступные в окне 
(1455 Уе\ мастера АЧа МетЬег УайаЫе УЙгага и Ааа Метьег ЕипсНоп УЛхага 
добавьте переменную-член и два прототипа функций, приведенные ниже. Ада 
Метрег Еипсйоп У/2агА одновременно сгенерирует в Ех17Б\1еуусрр шабло- 
ны этих функций. 


руб11с: 
11 т_пРаде; 

рг1\уате: 
\019 Ри1птРаденеадег( СОС» р0С); 
\019 Рг1п{РадеРоотег(С0С» рб); 


Переменная-член 7_пРабе хранит номер текущей страницы документа. 
Закрытые функции предназначены для подпрограмм, формирующих верхние 
и нижние колонтитулы. 

‚ Отредактируйте функцию Оп)гаш в Ех17БУ1еуу.срр. Переопределенная 
функция Опргаи просто рисует пузырьки в окне представления. Добавьте вы- 
деленный код: 


\019 СЕх176\1ем: :Оп0гам(С0С» роб) 
{ 
Пел} 


СЕх1760ос* р0ос = бетбоситепт(); 
] = р0ос->т_е111рзеАггау. бет/ррегВоипа(); 
Рог (1=0; 1<}; 1++) { 
р0С->Е111рзе(рбос->т_е111рзеАггау[11); 
} 
} 


. Вставьте функцию ОпРгерагерс в Ех17БУ1еуу.срр. Класс «вид» не предусма- 
тривает прокрутки в окне представления, поэтому режим преобразования ко- 
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ординат надо установить именно в этой функции. В окне Ргорегиез утилиты 
С!а5$ Ме\м переопределите функцию ОпРгерагерс и введите выделенный код: 


\019 СЕх17Б\1ем: :ОпРгерагебС( СОС» роб, СРг1иТпРо* рТпто) 
{ 

рОоС->5е1{МарМоде ( ММ_ЕГОЕМСЕТЗН); 
} 


8. Вставьте функцию ОпРгий в Ех17БУ1е\у.срр. Исходная функция СИеш::Оя- 
Рип! вызывает Опбгаш. Мы собираемся печатать информацию, отличную от 
выведенной на экране, поэтому в ОпйРИ{ надо обойтись без вызова Ои)гаш. 
Функция ОпРий сначала устанавливает режим ММ_Т\1Р5, потом создает шрифт 
фиксированной ширины. После распечатки числовых значений 12 элементов 
т_еШрзеАтгау шрифт отключается. Можно было бы создать шрифт лишь раз в 
ОпВевтРитипв, но в данном случае это не дало бы заметного выигрыша. В окне 
Ргорегие$ утилиты С1!а55 У1е\у переопределите функцию ОпР/ть а затем добавьте 
в нее выделенный код: 


\0149 СЕХ17Б\1ещ: : ОпРг1п(С0С* р0С, СРе1пТпРо* рТпРо) 
{ 

11 1, пофаге, пЕпд, пНе1оне; 

С5Ег1п9  З%Г; 

СРо1пЕ ро1п{(720, -1440); 

СРопе опт; 

ТЕХТМЕТАТС 1м; 


р0оС->5е{МарМоде ( ММ_ТМТР$); 
СЕх17600с» рбос = бе{боситеп*(); 
п_пРаде = рТпто->т_пСигРаде; // для функции Рг1пРадеРоотег 
потаге = (м_пРаде - 1) * СЕх17ЬОос: : п-1пезРегРаде; 
пЕпа = п5фаге + СЕх17Ь0ос: : пЕ1пезРегРаде; 
// фиксированный шрифт размером 14 пт 
Топф. СгеатеРоп{(-280, 0, 0, 0, 400, РАЕЗЕ, РАШЗЕ, 
0, АМЗТ_СНААЗЕТ, ОУТ_ОЕРАЦЕТ_РВЕСТ$, 
СЕТР_ОЕРАУЕТ_РВЕСТ$, ОЕРАЦЕТ_ОЦАЕТТУ, 
ОБЕРАЦЕТ_РТТСН ; ЕР_МОБЕВМ, “Соиг1ег № м"); 
// Соиг1ег №м - это ТгиеТуре-шрифт 
СРопф* р019РопЕ = (СРопф*) (р0С->$е1ест061ес+(&Роп+)); 
Рг1п{Раденеадег(роС); 
роС->бетТех{Метг1с3(&4т); 
пНе19й{ = 1т. +тНе19йЕ + м. {мЕхфегпа11еа91п9; 
Тог (1 = пэфагЕ; 1 < пЕпа; 1++) { 
11 (1 > р0ос->т_е111рзедггау. бе*ИррегВоипа()) { 
Ьгеак; 
} 
$1г. Рогмат("%64 %64 %64 %64 %649", 1+1, 
р0ос->т_е111рзеАггау[ 1]. 1е1+, 
рбос->т_е111рзеАггау[1].Тор, 
рбос->т_е111рзеАггау[1 ]. г19ВЕ, 
рдос->т_е111рзеАггау[ 1]. Бо{тот); 
ро1пе.у -= пНе19ит; 
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9. 


10. 


рОС->Техе0ит{(ро1п*.х, ро1пф.у, з1г); 
} 
Рг1п{РадеРоофег(р0С); 
р0С->5е1ес{06] ест(р019Роп*); 
} 


Отредактируйте функцию ОпРгерагеРттииз в Ех17БУ1еу.срр. Эта фун- 
кция, шаблон которой генерирует МЕС АррИсаНоп \/12ага, вычисляет количе- 
ство страниц в документе и — посредством функции 5еМахРавзе — сообщает 
резульгат каркасу приложений. Добавьте выделенный код: 


ВООЕ СЕх176\М1ем: :ОпРгерагеРг1п{1п9 (СРи1пЕТпРо* рТпРо) 
{ 
СЕх1760ос* рбос = бе{боситеп*(); 
рТпто->5е1МахРаде (рбос->т_е111рзеАггау. бетИррегВоипа() / 
СЕх17Ь0ос: : пЕ1пезРегРаде + 1); 
гефигп ОоРгерагеРг1п{1т9(рТпРо); 
} 


Вставьте в Ех17ЬУ1еу.срр функции, формирующие колонтитулы. Эти 
закрытые функции, вызываемые из ОпРимЬ печатают верхние и нижние ко- 
лонтитулы. Нижний колонтитул содержит номер страницы, сохраненный Оя- 
Рит в переменной-члене т_пРаве класса «вид». Функция СОС::беЙежмежмет! 
вычисляет ширину строки с номером страницы, чтобы ее можно было выров- 
нять по правому полю. Добавьте выделенный код: 


\014 СЕх176\У1ем: :Рг1п{Раденеадег( СОС» рос) 
{ 
С$г1п9 з{г; 


СРо1п{ ро1п{(0, 0); 
роС->ТехЕ0и{(ро1п{.х, ро1пф.у, “ВибБ1е Верог*”); 
ро1пЕ += 0512е(720, -720); 
з+г. Рогта{* ("6.63 %6.63 %6.63 %6.6$ %6.63", 

"Тпдех”, “Ёеге"”, "Тор", "В19пе", “Вофот"); 
роС->ТехЕ0и{ (ро1п{.х, ро1пф.у, 3з1г); 


\01а СЕх176\1ем: : Рг1п{РадеРоотег( СОС» рос) 
{ 
С51г1пд з+г; 


СРо1п{ф ро1п{(0, -14400); // Смещает на 10 дюймов вниз 

СЕх1760ос* р0ос = бе{боситеп*(); 

$1г. Рогтат ( "Боситеп{ #3”, (1РСУТВ) рбос->бетТ1+1е()); 

роС->ТехЕ0и{ (ро1п.х, ро1пф.у, з1г); 

зЕг. Рогтат ( "Раде %4", м_пРаде); 

0$12е 312е = р0С->бетТехфЕхфеп{ (з1г); 

ро1п{ф.х += 11520 - 317е.сх; 

роС->ТехЕ0и{(ро1п{.х, ро1пт.у, з1г); // выравнивание по правому краю 
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11. Соберите и протестируйте приложение. Запустив программу, вы увидите 
нечто вроде: 


Ен1ТЬ - ЦбЫНей 


При каждом выборе команды Ме\ из меню ЕЦе изображение на экране 


должно меняться, а в режиме Рип Рге\1е\ми первая страница должна выглядеть 
так: 


ор пы вавлан 


В диалоговом окне РипЕ можно задать диапазон печатаемых страниц. 


ГЛАВА 


18 


Разделяемые окна 
и множественное 
представление данных 


Во всех программах, с которыми вы имели дело до сих пор, кроме Ех16Ь, было 
только одно связанное с документом окно представления. Если вы работали в каком- 
нибудь текстовом процессоре для УЛп9о\5, то знаете, насколько удобно, когда 
разные части одного документа открыты сразу в двух окнах. Оба окна могут по- 
казывать документ в обычном виде, а могут, скажем, и так: одно окно находится в 
режиме разметки страницы, а другое — в режиме структуры. 

Каркас приложений позволяет реализовать множественное представление 
документа несколькими способами, в том числе разделением окна на секции (зрИцег 
улпао\) и созданием нескольких дочерних МП]-окон. В этой главе мы рассмот- 
рим оба варианта, и вы увидите, что сформировать множество оббектов одного 
класса «вид» (обычное представление документа) не так уж трудно. Немного слож- 
нее использовать в одном и том же приложении два или более класса «вид» (на- 
пример, виды структуры и разметки страницы). 

В этой главе мы сделаем упор на создании нескольких представлений. В при- 
мерах предполагается, что данные документа инициализируются в функции Ои№ и- 
Доситет. Советуем обратиться к главе 15, чтобы освежить знания о взаимодей- 
ствии «документ-вид». 


Разделяемое окно 


Это окно — особая разновидность окна-рамки; каждая его секция (рапе) содер- 
жит свое представление документа. Разбить окно на секции может сама програм- 
ма при его создании или пользователь, выбрав соответствующую команду меню 
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либо переместив маркер разбиения на полосе прокрутки. После того как окно 
разбито на секции, маркер разбиения позволяет корректировать размеры секций 
(для этого его перемещают мышью). Разделяемые окна применяются как в $П1-, 
так и в МП!-приложениях. 

Разделяемое окно — объект класса Сурийе" та — полностью занимает клиент- 
скую область окна-рамки (класса СРтате\иа или СМЫСЬИа\Упя), а в его секциях 
располагаются окна представления. Разделяемое окно не участвует в маршрути- 
зации команд. Активное окно представления (в секции разделяемого окна) логи- 
чески связано напрямую с окном-рамкой. 


Варианты создания множественных 
представлений 


Реализовать множественное представление с моделями приложений можно не- 
сколькими способами. : 


Ш ЮГ приложение с разделяемым окном, один класс «вид». Этот вариант 
реализован в программе Ех18а. Каждая секция независимо от других позволя- 
ет прокручивать содержимое документа до любого места. Программист зада- 
ет максимальное число горизонтальных и вертикальных секций, а пользова- 
тель при работе с приложением сам разделяет окно. 

Ш 50Г-приложение с разделяемым окном, несколько классов «вид». Этот 
вариант показан в примере Ех18Ъ. Программист задает число секций и после- 
довательность формирования объектов «вид», а пользователь при работе с 
приложением может изменять размеры секций. 

Ш $ОГприложение без разделяемых окон, несколько классов «вид». Этот 
вариант воплощен в программе Ех18с, Пользователь переключает классы «вид», 
выбирая соответствующие команды меню. 

Ш МОГ- приложение без разделяемых окон, один класс «вид». Это стандар- 
тное МО!-приложение вы видели в главе 16. Командой Мех УЛпао\/ можно было 
создать новое дочернее окно для уже открытого документа. 

Ш МОГприложение без разделяемых окон, несколько классов «вид». Это 
разновидность стандартного МП1-приложения, позволяющая работать с мно- 
жественным представлением документа. Как показано в примере Ех18а, для 
этого нужно лишь заменить М№е\у УЛп4оуу командами, соответствующими каж- 
дому из доступных в программе классов «вид». 

Ш МОГ приложение с разделяемыми дочерними окнами. Этот вариант по- 

дробно рассмотрен в электронной документации «МЕС Бгагу ВеГегепсе» на 
примере программы ЗСЕВВГЕ. 


Динамически и статически разделяемые окна 


Динамически разделяемое окно (4упапис зрИиег улпао\) можно разделять в лю- 
бой момент, выбирая соответствующую команду или перемещая маркер разбие- 
ния на полосе прокрутки. Секции в динамически разделяемом окне обычно свя- 
заны с одним классом «вид». Верхняя левая секция показывает выбранное пред- 
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ставление данных сразу после создания разделяемого окна. Полосы прокрутки — 
общие для всех секций. Например, в окне, разбитом по горизонтали на две сек- 
ции, нижняя полоса прокрутки управляет обоими окнами представления. При 
запуске приложения с динамически разделяемым окном формируется единствен- 
ный объект «вид». Когда пользователь разделяет окно-рамку, создаются другие 
объекты «вид», а когда «воссоединяет» его, эти объекты уничтожаются. 

Секции статически разделяемого окна (5айс зрИиег улп4оу) определяются 
при создании окна; пользователь вправе изменять их размеры, но не число. Ста- 
тически разделяемые окна подходят для нескольких классов «вид»; при этом кон- 
фигурация окон устанавливается при их создании. В статически разделяемом окне 
у каждой секции свои полосы прокрутки. В. приложении со статически разделяе- 
мым окном все объекты «вид» конструируются при создании окна-рамки и уда- 
ляются при его уничтожении. 


Пример Ех18а: $01-приложение с динамически 
разделяемым окном и одним классом «вид» 


В этом примере окно можно динамически разделить на четыре секции, что при- 
водит к формированию четырех объектов «вид», и всеми управляет один класс «вид». 
Код классов «документ» и «вид» мы возьмем из примера Ех17а. Добавить динами- 
чески разделяемое окно к новому приложению поможет МЕС АррИсаЧоп У/лага: 
создайте $О1-приложение и на странице Озег пиегасе Есаагс$ установите флажок 
Ур улп4о\ (использовать разделяемое окно): 


МЕС Аррйсаноп \/гаг 4 ЕТ ва 


\5ег цегТасе Реаиге5 
Эресёу орНопз РаЁ согёго! Ве оо апЧ Ге! оЁ уси аррйсаёюп. 


При этом МЕС АррИсайоп УЛгага добавит код к классу СМатЕгате. Разумеется, к 
существующему приложению такой код придется добавить вручную. 


Ресурсы для разделения окна 


Генерируя приложение с разделяемым окном-рамкой, МЕС АррИсайоп У\/1хага 
дополняет меню У1е\ проекта командой 5$рШ. Идентификатор команды, [2_УМ- 
РО 5РИТ, соотносится с функцией-обработчиком класса Се из библиоте- 
ки МЕС. 
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СМатЕгате 


Классу основного окна-рамки приложения нужна переменная-член, связанная с 
разделяемым окном, и прототип переопределенной функции ОпСтешесйети. Сле- 
дующий код МЕС АррИсаНоп \УЙтага добавит в файл МашЕгт.В: 


рготестед: 
С5р11 {египта т_мпа$р11тег 
риб11с: 
У1гфиа1 ВООЕ ОпСгеафеС11еп1 (ЕРСВЕАТЕЗТВИСТ 1рсз, ССгеафеСопфехе» рбопфехЕ): 


При создании объекта-рамки каркас приложений вызывает виртуальную фун- 
кцию-член СЁЕгате\па;::ОпСтешесйети. Базовый класс формирует единственное 
окно представления, определенное в шаблоне документа. Функция ОпСтешеСЦети, 
переопределенная мастером МЕС АррИсайоп \У/2ага в МашЕгт.срр (см. ниже), 
создает вместо этого разделяемое окно, а то в свою очередь формирует первое 
окно представления: | 


ВООЕ СМа1пЕгате: : ОпСгеафеС11еп{( ЕРСВЕАТЕЗТВИСТ /*1рсз*/, 
ССгеатеСоптехе* рСоптехе) 
{ 


гефтигп тм_мп95р111ег. Сгеате( +115, 


ана // Т000: аа)изф 4пе пимбег о гом$, со1итп$ 
($17е(10, 10), // 1000: аа)изе Не т1п1тит рапе $17е 
рСопфех{); 


Функция-член С5рйшетупа::Стеше создает динамически разделяемое окно. Класс 
«вид» известен объекту С5рийей па, поскольку имя этого класса внедрено в струк- 
туру ССтежеСоте>х, передаваемую в Стеше как параметр. 

Второй и третий параметры функции Сгееие (2, 2) указывают, что окно можно 
разбить максимум на две строки и на два столбца (т. е. на 4 секции). Заменив (2, 2) 
на (2, 1), вы получите две горизонтальные секции, а (1, 2) дадут две вертикаль- 
ные. Параметр С51е определяет минимальный размер секции. 


Тестирование приложения Ех18а 


После запуска Ех18а окно можно разделить командой $рШ меню У!е\/ или мар- 
керами разбиения на полосах прокрутки. Ниже показано окно представления, 
разделенное на 4 секции (рис. 18-1). На все представления приходится один на- 
бор полос прокрутки. 


Пример Ех18Ь: $0|!-приложение с статически 
разделяемым окном и двумя классами «вид» 


Ех18Ь — расширенный вариант программы Ех18а; в ней определен второй класс 
«вид», благодаря чему в статически разделяемом окне располагаются два представ- 
ления одного документа. (СРР- и Н-файлы взяты от первоначального класса «вид».) 
На этот раз разделяемое окно ведет себя чуть иначе. При запуске сразу форми- 
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руются две секции, и пользователь вправе варьировать их размер маркером раз- 
биения на правой полосе прокрутки или командой 5рШ из меню УЛпо\у. 


ПуЕх1Ва - ЦпЫед 


01 02 


01 02 


Тье реппусвпду те Беуопё Че Е1 
18 увеге | $154 

ею 1юуе | 

1 СТО 301 
]еЙубеаля &очие Я шп Ве зепу- в]оот 
оРВа! зереабет аЙеглоой 
А са! порой Ве сощийег зпоуед атопё 
Че Бсойсе зисКз 
зад 1юоние 1015 


а 


01 02 


Тье реплусваду те беуоп@ 1Ве Е1 
15 иБеге 1 6:54 
#21 ш1оуе : 
1] эф дпгеаШ у 1 
Ле Пубеалз вое п 1Ве вепу- Лост 
оР\ва4 зерйетбет аЙегтлоой 
А са рой {Ве сомайег тоуед атопё 
Че Бсопсе иске 
ап ло оные гой5 


Тье реппусвадуоте феуоп4 1Ве Е1 
18 увете [ биз 
Зе п 1оуе 
эВ цогеаШу 
ЗеЦубеалз &1очие Я #1 {ре зепи- оо 
оР4раф зерфетф ег аЙеглоой 
А са арой пе социйег моуед атопё 
ЧВе Нсойсе эНсК; 

ап 1001516 гоШ5 

ста Ты 


01 "02 


Тье реплусапду1оте 5еуопа ве Е! 
15 уБеге 1 био 
еп 1оуе 
ИВ цагеаШу 
УеЙубеаиз &]о\ге д в 1Ве зепи- оо 
оР\рай зерйезабех айеглоой 
А са арой {Ве сомайег поуед атопё 
Чве Всонсе ск 
ап 100% гоЙ8 


Рис. 18-1. Единственное окно представления, разделенное на четыре секции 


Простейший способ создать приложение со статически разделяемым окном — 
сгенерировать его с динамически разделяемым окном с помощью МЕС АррИсацоп 
УЛгагА и отредактировать функцию СМатЕгате::ОпСтешеСйети. 


СНехМеи 


Класс СНехШеи адресован любителям поэзии в шестнадцатеричном виде. Он от- 
личается от Сия Шеш только функцией-членом Оп)гаш: 


014 СНех\у1ем: : ОпОга(С0С» рос) 
{ 


// шестнадцатеричный дамп строк документа 


11 ЕЕ Е СПНОТОПЫ 
С51г1п9 оифри 1 пе, э1г; 
СРопе Топт; 


ТЕХТМЕТВТС  \п; 


СРоет0ос» р0ос = бетбоситепт(); 

Топ. СгеатеРоп{(-160, 80, 0, 0, 400, РАЕЗЕ, РАЕЗЕ, 0, АМЗТ_СНАВЗЕТ, 
О0Т_ОЕРАЦЕТ_РВЕСТ$, СЕТР_ОЕРАУЕТ_РВЕСТ$, БЕРАЦЕТ_ОЦАЕТТУ, _ 
БЕРАЦЕТ_РТТСН : РР_$5МТ$$, “Аг1а1” ); 

СРопе* р019Роп{ = р0С->5е1ес{063]ест(&Ропт); 

р0С->бетТех{Метг1с$ ( &1т); 

пНез9п{ = 1мт. тмНетой{ + 1м. {мЕхфегпа11еа91п9; 


] = р0ос->т_3{г1пдАггау. ве1512е(); 
РЕ И О Е им 
оифри{ 1 пе. Рогтат("%02х “”, 1); 
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1 = р0ос->т_$г1пдАггау[1 ]. бетьепдаен(); 
Рог (К=0; К<1; К++) { 
п = р0ос->м_31г1пдАггау[11[К] & 0х00тЕ; 
3Ёг. Рогта{ ( "%02х “", п); 
оифри{Ё1те += з{г; 
} 
роС->Тех{0и{(720, -1 * пНе1тапе - 720, оифри пе) 
} 
р0С->5е1ест06]ес+(р019Роп*): 


Эта функция показывает шестнадцатеричный дамп всех строк в наборе 7и_5й7ир- 
Аттау документа. Обратите внимание на оператор индексации, используемый для 
доступа к отдельным символам в объекте С5йтию. 


СМатЕгате 


Как ив Ех18а, классу основного окна-рамки в Ех18Ь нужна переменная-член, свя- 
занная с разделяемым окном, и прототип переопределенной функции ОиСтеше- 
СИет. Чтобы сгенерировать код, используя МЕС АррИсайоп \Йтата, установите 
флажок 5р№Е \Чпаоу (как в Ех18а). При этом модифицировать файл МашЕгт.В не 
придется. 


Для файла реализации (МашЕгт.срр) нужны заголовочные файлы классов «до- 
кумент» и «вид»: 


#1т1пс1и4е “Роетдос. п” 
Нпс1и9е “ЭЕг1паУлем. п” 
#1ис1и49е “Нех\/тем. п” 


МЕС АррИсацоп УЛгага генерирует в функции ОиСтешеСйеп! код динамичес- 
ки разделяемого окна, поэтому, чтобы сформировать статически разделяемое окно, 
эту функцию придется подправить. Вместо С5рйиейпа:.Стеие вы должны вызвать 
функцию С5рИйетупа::СтежмеЯаис — она предназначена для работы с нескольки- 
ми классами «вид». Последующие вызовы Сурийейпа::Стецетеи» подключают два 
таких класса. Последние два параметра (2, 1) функции Стеще%айс заставляют фор- 
мировать разделяемое окно с двумя секциями; при этом в начальном состоянии 
разделительная линия отстоит от верхней части окна на 100 единиц (в аппарат- 
ных координатах). Верхняя секция — это обычное (текстовое) представление до- 
кумента, а нижняя — его шестнадцатеричный дамп. Положение разделительной 
линии изменять можно, а конфигурацию представления — нет. 


ВООГ СМа1пЕгаме: : ОпСгеафеС11еп+ (ЕРСВЕАТЕЗТВИСТ /*1рс$*/, ССгеатебопфехе» рСоптехт) 
{ 
УЕНТРУ (п_мп9$р11 тег. СгеатеЗат1с(+113, 2, 1)); 
\УЕВТРУ(т_мп9$р1141ег. Сгеае\1ем(0, 0, ВОМТТМЕ_С1А$$ ( С5Ег1па\1ем), 
С512е(100, 100), рСоптехе)); 
УЕВТРУ(т_мп9$р11 ег. Сгеате\1ем(1, 0, ВОМТТМЕ_С1А$$( СНех\1ем), 
С$12е(100, 100), рСоптех+)); 
гефигп ТВОЕ; 
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Тестирование приложения Ех186 


После запуска окно программы Ех18Ь будет выглядеть, как показано на рисунке. 
Обратите внимание: в каждой секции свои горизонтальные полосы прокрутки. 


Те реппусапфузвоте беуоп йе Е1 
18 уБете 1 бгей 
{еп 1оуе 


мин дохеаШу 
Тейубевия &1очие а 1Ве сепи- Е]оот 
оР4раф зерфелбег аЙегтлосй 
А са ароп {Ве содийег тоуе д атойё 


54 68 65 2070 65 6е 6е 79 63 61 6е 64 79 73 74 61 72 65 20 62 65 79 61 6е 64 20 74 68 65 20 45 6с 
69 7320 77 68 65 72 65 20 49 20 66 69 72 73 74 
20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 66 65 6с 6с 20 69 6е 20 6с 61 76 65 - 
202020 2020 20 2020 20 20 20 20 20 20 20 20 20 20 20 20 20 20 77 69 74 68 20 75 6е 72 65 61 6с 69 74 79° _ 
4а 65 6с 6с 79 62 65 61 6е 73 20 67 6с 61 77 65 64 20 69 6е 20 74 68 65 20 73 65 64 69 24 67 6с 51 61 69 
61 66 20 74 68 61 74 20 73 65 70 74 65 64 62 65 72 20 61 66 74 65 72 6е 51 61 6е 
41 20631 74 20 75 70 61 6е 20 74 68 65 20 63 61 75 6е 74 65 72 20 64 61 76 65 64 2061 69 616е 57 
20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 74 68 65 20 6с 69 63 61 72 69 63 65 20 73 74 
08 20202020 2020 20 2020 20 20 20 20 20 20 20 20 20 61 6е 64 20 74 61 61 74 73 69 65 20 72 61 6с 6с 73 


Пример Ех18с: переключение между 
классами «вид» без разделения окна 


Иногда надо программно переключаться между классами «вид»,-а связываться с 
разделяемым окном не хочется. Так вот, пример Ех18с — это $ОГ- приложение, 
которое переключается между Сие и СНехТеил в ответ на команды из меню 
\теуу. При создании приложения средствами МЕС АррИсаНоп \712аг4 вам требует- 
ся лишь добавить две новые команды в меню и немного кода в класс СМатЕгате. 
А еще сделать ранее защищенные конструкторы СУ еи и СНехМеи открытыми. 


Требования к ресурсам 
В ресурс меню ШК_МАМЕКАМЕ к меню У1е\ добавлены два элемента. 


Элемент меню Идентификатор команды _СМашЕгате-функция 
еитв Меи Ш_ИЕУ_$ТЫМСЙЕМ опмеиз$итатеи 
@Нех Иеи Ш_ИЕУ_НЕХИЕЯУ ОптешНех"еи 


Функции-обработчики команд (и обработчики обновления командного пользо- 
вательского интерфейса) добавляются в класс СМатЕгате в окне Ргорегиез ути- 
литы С1а$$ У1еуу. 


СМатЕгате 


Класс СМатЕгате дополняется закрытой вспомогательной функцией ЗшИсрОМе, 
вызываемой из двух обработчиков команд меню. Параметр перечислимого типа 
сообщает функции, на какой из объектов «вид» ей переключиться. Следующий код 
надо добавить в заголовочный файл МашЕгт.В: 
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рг1уате: 
епим е\1ем {5ТАТМ@ = 1, НЕХ = 2}; 
№0149 би1фспТо\М1ем(е\/1ем п\У1ем); 


Чтобы найти и активизировать запрошенный объект «вид», функция шись ое 

(в МашЕгта.срр), делает ряд низкоуровневых вызовов МЕС-функций. Не забивай- 

_те себе голову тем, как все это работает, — вы всегда сможете адаптировать эту 
функцию к своей программе. Добавьте этот код: 


\у014 СМа1пЕгате: : Зил ЕспТо\1ем(е\1ем п\У1ем) 
{ 
С\1ем» рО19АсЕауе\у1ем = бехАст1уе\1ем(): 
СУ1ем» рМемАсЕ1\уе\1ем = (С\1ем») бет0191%ет(п\Узем); 
1е (р№емАсеаме\1ем == МЕ) { 
Зм1Еев (п\У1ем) { 
сазе УТАТЮС: 
рМемАсе1уе\/1ем = (С\1ем*) пем СЗг1пд\М1ем: 
бгеак; 
сазе НЕХ: 
рМемАс1уе\1ем = (С\У1ем»*) пем СНех\1ем: 
бгеак; 


} 
ССгеафеСоптех{ соптехт; 
соптех{.т_рСиггепЕВос = р019АсЕ1уе\1ем->бе{Обоситеп{(); 
рМемАст1уе\1ем->Сгеате( Ми, МЕ, М$_ВОНОЕВ, 
СЕгатемпа : : гес&ОеРаи11, 4113, п\У1ем, &соптехЕ); 
рмемАс1уеУ1ем->0п1Тп1{1а1/рдате(); 
} 
ЗетАст1ме\1ем( рМемАсе1уе\1ем); 
рМемАс{1уе\/1ем->ЗпомМ1 пдом( $М_$НОМ); 
р019Ас+1уе\1ем->Эпом\1паом( $М_НТОЕ); 
р019Аст1уе\1ем->5е1019С%г110( 
рО19Аст1уе\1ем->бетВип1теС1азз() == 
ВОМТТМЕ_С1А$$ ( СЭЕг1пд\/1ем) ? УТАТАМ6 : НЕХ); 
рМемАст1уе\/1ем->5е1019С4г1Т0(АЕХ_ТОМ_РАМЕ_ЕТВЗТ); 
Веса1сЁауоит{(); 


А теперь рассмотрим обработчики команд меню и обновления командного 
пользовательского интерфейса, первоначально сгенерированные мастерами окна 
С1а55 У1еуу (вместе с элементами таблицы сообщений и прототипами). Обработ- 
чики, обновляющие пользовательский интерфейс, проверяют класс активного 
объекта «вид». 


\014 СМа1пЕгате: : ОпУ1ем$г1пд\/1ем() 
{ 

Зм1ЕспТо\1ем( ТАТА); 
} 


у01а СМа1пЕгаме: : Оп/рдае\1ем$ г1пд\У1ем(ССтаиТ» рСтаит) 
{ 
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рстаут->Епаб1е( ! вбетАсЕ1уе\1ем( )->Т3К1п90+(ВИМТТМЕ_С1А$$ ( СЗ+г1пд\У1ем))); 


\01 СМалпЕгате: :Оп\/1емНех\1ем() 
{ 
Зм1ЕспТо\1ем( НЕХ); 


\019 СМа1пЕгате : : Оп/рдате\у1емНех\/1ем( ССтауТ* рСта(т) 
{ 
рСтаит->Епаб1е( | бетАс+1уе\/1ем( )->ТзК1па0{(ВУМТТМЕ_С1А$$(СНех\У1ем))); 


Тестирование приложения Ех18с 


Ех18с изначально отображает документ в окне представления класса С5й1ив- 
Иеш. Вы можете переключаться между С5Иитееи и СНехе, выбирая соответ- 
ствующую команду из меню У!1еу (рис. 18-2). 


Тре реппусапдуз1юте беуоп8 Че Е! № 54 68 65 20 70 65 6е 6е 79 63 61 6е 
13 "бете 1 Втзь | 69 73 20 77 68 65 72 65 20 49 20 66 
Ее зп 1оуе Ё Е 20 20 20 20 20 20 20 20 20 20 20 20 2" 
ИВ могев у _ № 20202020 202020 20202020 202 


ТеЙубеапз Б]омге д 1 Ве зеиу- Е] оо 


4а 65 6с 6с 79 62 65 61 бе 73 20576 
6166 20 74 68 61 74 20 73 65 70 74 6 
41 206361 74 20 75 70 61 6е 20 74 6 
рае 2020202020 2020202020 20202 
\Ве Нсонсе $Нскз . 2020202020 2020202020 20202 


ап $0051 1018 _ № 20 202020 20 20 20 20 20 2020616 = 
за9 ОБ Воу Сми _ № : 


оЁ\ваЁ зерйезиег аЙегтосой 
А са ороп Ве социфег поуе ащойё 


Рис. 18-2. Представление документа объектами СуттяТеи и СНех\еш 


Пример Ех18а: МО!-приложение 
с несколькими классами «вид» 


В заключительном примере для создания МПГ-приложения с несколькими клас- 
сами «вид» без разделяемого окна используются предыдущие классы «документ» 
и «вид». Его логика отличается от логики других программ с несколькими класса- 
ми «вид». Основные события здесь разворачиваются в классе приложения, а нев 
классе основного окна-рамки. Изучая Ех184, вы глубже вникнете в работу с объек- 
тами СРос1етр а. 

Эта программа сгенерирована с установленным флажком Сощех(-зепиуе Нер 
на странице Аауапсе4 Ееагагез мастера МЕС АррИсаНоп \У/Л2ага. Если вы начинае- 
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те с нуля, создайте средствами МЕС АррИсайоп \лхаг обычное МПО!-приложение 
с одним из классов «вид». Затем добавьте к проекту второй класс «вид» и модифи- 
цируйте файлы классов приложения и основного окна-рамки. 


Требования к ресурсам 


В ресурс меню ШК_ЕХ18РТУРЕ к меню У/тао\ добавлены два элемента. 
АВЕ ах 


Элемент меню Идентификатор Функция 

(свойство СарНоп) команды СМатЕгате 

№ @5бттв Утаои (заменяет Ш_ИМРО МЕЖЗТЮМСУМРОЙ  СМЫЕгате\иа::Оп- 

команду Ме УЛпао\) УйпаошМ№еш 

№ и ©Нех Утаош Ш_УМРОУ_МЕУНЕХУЛМРОЙ ОпутаоиМешьех- 
\Утаош 


Обработчик команды Оп ЙтаошМеифех в классе СМатЕтате создайте в окне 
Ргорегие$ утилиты С!а$$ У1еуу. 


СЕх18ААрр 


В заголовочный файл класса приложения (Ех184.В) добавьте переменную-член: 


риб11с: 
СМи1{1осТетр1ате* т_рТетр1атеНех; 


Файл реализации Ех184.срр должен содержать операторы #йтсшае: 


#11с1иде “Роет)ос. п” 
Нпс1иае “З&г1па\У1ем. п" 
#1пс1иде “Нех\1ем. В” 


В функцию-член МиЙияатсе класса СЕх18ААрр вставьте следующий код сразу 
после вызова функции Ааарос1етриие: 


т_рТетр1афеНех = пем СМи1+10осТетр1ате( 
ТОВ_Ех18аТУРЕ, 
ВОМТТМЕ_СТА$5$ ( СРоетбос), 
ВОМТТМЕ_СЕА$$(ССВ119Егаме), 
ВОМТТМЕ_СЕАЗЗ (С$г1пд\Узем)); 


Вызов АЧаросТетрше, сгенерированный МЕС АррИсаНоп УЛгага, устанавливает 
для приложения первичную комбинацию «документ/рамка/вид», действующую при 
запуске программы. Показанный выше объект шаблона — это вторичный шаблон, 
который активизируется в ответ на выбор в меню команды Ме\ Нех УЛюдо\. 

Остается создать функцию-член Ехйтяапсе, которая очищает вторичный 
шаблон: 


11 СЕх189Арр: : Ех1ТпзТапсе() 
{ 
9е1ефте пт_рТетр1атеНех; 
гетигп СМЗпАрр: : Ех1Тп$фапсе(); // сохраняет параметры профиля 
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СМатЕгате 


Файл реализации класса основного окна-рамки (МашЕгт.срр) включает заголо- 
вочные файлы класса СНех\У1еу и класса «документ»: 


#1пс1и4е "Роетбос. п” 
{1ис1иаде “Нех\У1ем. п” 


В базовом классе окна-рамки СМЫЁЕтате\па есть функция ОптаошМеи,, 
обычно связываемая со стандартной командой Ме\уу УЛпао\ меню УЛпаоху. В Ех184 
с этой функцией связана команда меню Ме\ Зите УЛюаох,, связанная с обработ- 
чиком (его текст приведен ниже), который и создает новые дочерние окна с ше- 
стнадцатеричным представлением. Эта функция создана на основе ОпИтаошМ№еи 
и адаптирована для работы со вторичным шаблоном, определенным в /ийЙтяатсе. 


\014 СМа1пЕгате: :Оп\1пдомМемпехм1пдом() 
{ 
СМОТСВ119\п4* рАс+1\еСв1149 = МОТбетАст1уе(); 
СВоситеп* рбоситепт; 
11 (рАсф1уеСв119 == МЕ 1: 
(рбоситепф = рАс1\еСв119->бетАс+1уебоситепе()) == МИ) { 
ТВАСЕ( “Магп1п9: № асф1\е доситепЕ Гог М1пдом№ем соттапа\п”) 
АгхМеззадеВох( АЕХ_ТОР_СОММАМО_РАТЕЦВЕ); 
гефигп; // Сбой команды 


// В противном случае создается новое окно-рамка! 
СОосТетр1афе* рТетр1афе = 
((СЕх189Арр») АРхбетАрр())->т_рТетр1афеНех; 
АЗЗЕВТ_МАЕТО(рТетр1ате); 
СЕгате\п9»* рЕгате = 
рТетр1а{е->Сгеа+еМемЕгате ( рОоситепт, рАсф1\еСп11а); 
1е (рЕгате == МУ) { 
ТВАСЕ( "Магп1п9: №а11е9 фо сгеафе пем Ггате\п”); 
АРхМеззадеВох( АЕХ_ТОР_СОММАМО_РАТИЦВЕ); 
гефигп; // Сбой команды 


рТетр1ате->Тп1{1а1/рдатеРгате( рЕгате, рбоситеп{); 


Примечание Продемонстрированное выше «клонирование» функций — очень 
полезная технология программирования на базе МЕС. Ее суть проста. 
Найдите функцию базового класса, которая делает максимум того, что 
вам нужно, и скопируйте ее из подкаталога \Ус7\аШтЕс\5гс\паЕс в свой 
производный класс и отредактируйте. Правда, есть риск, что в будущих 
версиях МЕС-библиотеки найденная вами функция окажется реализован- 
ной иначе. 
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Тестирование приложения Ех184 


После запуска приложения Ех184 на экране появится дочернее окно с текстовым 
представлением. Выберите в меню УЛп4о\ команду М№е\ Нех УЛпдоу%, у вас дол- 
жно получиться что-то вроде этого: 


02 


Тье реппусапду1оте еуоп ве Е! 
15 уБеге 1 биб\ 
ЕеШ3а 1оуе 
м дагеаН у 
`ТеЦубеалз очей фе зепу- вост, 
ОР зерйетьег айетоой 


54 68 65 20 70 65 Бе 6е 79 63 61 бе 64 79 73 74 61 72 65 20 62 65 79 61 6е 64 20 74 68 65 20 45 6с 

69 73 20 77 68 55 72 65 20 49 20 66 69 72 73 74 

20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 66 65 6с 6с 20 69 6е 20 6с 61 76 65 

20 2020 2020 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2077 69 74 68 20 75 6е 72 65 61 6с 69 74 

4а 65 6с 6с 79 62 65 61 6е 73 20 67 6с 61 77 65 64 20 69 6е 20 74 68 65 20 73 65 64 69 24 67 6с 61 61 64 

6166 20 74 68 61 74 20 73 65 70 74 65 69 62 65 72 2061 66 74 65 72 6е 61 61 6е 

41 206361 74 20 75 70 61 6е 20 74 68 65 20 63 61 75 бе 74 65 72 20 64 61 76 65 64 20 61 54 61 6е 67 Е 

20 2020 20 20 20 20 2020 20 20 20 202020 20 20 20 20 20 20 74 68 65 20 6с 59 63 61 72 69 63 65 20 737 

20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 61 6е 64 20 74 61 61 74 73 69 65 20 72 61 6с 6с 73 
5+ 
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Контекстно-зависимая 
справка 


Саавы существуют два вида технологии интерактивной справки: в формате НТМГ, 
(Нурецехе МагКир Гапзиазе) и классический формат УЛюНе!р. Программы на ос- 
нове МЕС поддерживают оба вида, но популярность НТМГ Нер неуклонно рас- 
тет, о чем свидетельствует новая интерактивная документация по У150а1 С++ МЕТ 
в формате НТМЕ Не]. 

В этой главе мы покажем, как создавать и обрабатывать простой автономный 
файл справки, содержащий оглавление и поддерживающий переходы между раз- 
делами. Далее вы увидите, как программа на основе МЕС-библиотеки активизиру- 
ет справочную систему, передавая ей идентификаторы контекста справки, про- 
изводные от идентификаторов окна и команд. И, наконец, вы узнаете, как изме- 
нить в МЕС схему маршрутизации сообщений справочной системы в соответствии 
со своими потребностями. 


МИпНер и НТМЕ Нер 


Вообще выбор между УЛмНер и НТМГ Нер — вопрос личных предпочтений. 
Программный интерфейс доступа и управления обеими справочными система- 
ми одинаков. В \УЛпНер применяется текст с форматированием (В1сВ ТехЕ Еоглаф, 
ВТЕ), а в НТМГ Нер — НТМГ-текст. В последнее время появилось множество ком- 
мерческих средств создания справочных систем для УЛпао\5, в том числе Воро- 
НЕГР от Вше $Ку бой\маге и ЕогеНе!р от Еогейоп: Согрогайоп, которые преврати- 
ли создание справочных систем в формате УЛпНер в простую задачу. Однако 
УЛпНе!р, по-видимому, со временем уступит дорогу НТМГ, Нерр. 

В классической УЛпНе!р-системе доступ к разделам последовательный: доступ 
к разделам-темам осуществляется через предметный указатель (шаех) или оглав- 
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ление. Выбранный раздел \ЛпНе!р открывает в отдельном окне, Вот пример окна 
справочной системы \ЛаНе!р, по умолчанию создаваемой МЕС АррИсаноп У/гага: 


неф Тор \илнер Аррсавов Неф 


Ш Мепиз 
Е Аве тепу 
[2] ЕЯ тепи 
2] Мем тепи 
\\Ипдом тепи 

| Нер тепи 

99 иочг зррйсаноп-зрасйс юр 
2] <<ача уочг(орю [чтрз Неге>> 


С $ 96 
| Ре тепи соттал@ 


: Те РИе тепи оНегз {пе ‘о!омипа соттала: 


Стеа!ез а пе\и Чоситем. 
Орепз ал ехейио Чоситепь 

Созез ап орепед доситеги 

Зауез ап орепед Чоситеп изтд Не зате Ме пате. 

Зауез ап орепед Чоситеп о а зресйед #е пате. 

Рип а Чоситеги 

‚ Орауз не Чоситег! оп ве зсгееп аз й мой арреагримед. 
Зе!ес8 а римегапа рищег соппесбоп. 

Зепаз \Ве асфуе доситепИИгоидн е-тай 

ЕхИ$ <<«УошАрр>>. 


А на следующей странийе показан пример окна справочной системы НТМ!, Нер, 
которое по умолчанию создавает МЕС АррИсаНоп УЛ гага: в левой панели окна — 
вкладки шаех (предметный указатель), Согиепи$ (оглавление) и Зеагсв (поиск), а 
в правой — содержимое раздела. 

НТМГ Нер реализована на основе АсНуеХ-элемента управления ННСИ1.осх, 
который отвечает за навигацию и управление дополнительными и всплываю- 
щими окнами. ННСи1.0осх достаточно гибок, чтобы отображать и скомпилиро- 
ванные файлы справки, и НТМТ-страницы, которые обычно отображаются в 
У/еБ-браузере. 

Сначала мы познакомимся с работой УЛпНе!р в МЕС-приложении. 
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<<УошАрр>> Неф Тадех 


Ноу То... 


| зкавиз Баг 
 ооба 


<< А4З уст аррЁсаноп-зресйс пом/-фю 
фор1сз Веге. >> 


Сопипаи4$ 
Ее шепи 
Ед пепла 


| чем таепы 


МИпаом!$-программа с \МтНер 


Если вы работали с коммерческими УЛюао\з-приложениями, то, наверное, обра- 
щали внимание на их справочные системы со сложными страницами с графикой, 
гиперссылками и всплывающими окнами. Создание справочных систем стало 
профессией. Эта глава не сделает вас экспертом по справочным системам, но 
позволит с чего-то начать и подготовить простой справочный файл без особых 
«наворотов». 


Текст с форматированием 


В УЛюао\5$ 50ОК рассказывается, как создавать текстовые А$СП-файлы справки в 
стандарте ВКТЕ Мы тоже воспользуемся этим ВТЕ-форматом, но будем работать в 
режиме \/УЗТУ/УС, избегая прямого обращения к громоздким последовательнос- 
тям управляющих символов (Е$с-последовательностям). Будем применять в спра- 
вочном файле те же шрифты (тех же размеров и начертания), которые пользова- 
тель нашей программы увидит в окнах справочной системы. Естественно, нам 
понадобится текстовый редактор, работающий с форматом ВТЕ Лично мы пред- 
почитаем Мисгозой \/ога, но формат ВТЕ понимают и многие другие текстовые 
редакторы. 


Подготовка простого справочного файла 


Давайте напишем простой справочный файл с оглавлением и тремя тематичес- 
кими разделами. Этот файл предназначен для чтения напрямую из УЛаНе]р. На С++ 
ничего программировать не надо. 

1. Создайте подкаталог \усрр32\Ех19а. 


2. Напишите текст основного файла справки. В М!сгозой У/огА (или другом 
ВТЕ-совместимом текстовом редакторе) наберите текст. 
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Текст с зачеркиванием 
Текст с одинарным подчеркиванием 
Текст с двойным подчеркиванием 


Скрытый текст 


Нер-Тор:с.11 

1 

Тв ВеЧехе-ог-Ве!р\ор1с-пилиь ег. 1.4 Разрыв страницы 

Ч вставляется 
сочетанием 
СиИ+Ещег 


Проверьте, правильно ли вы применили режимы двойного подчеркивания 
и скрытого текста и правильно ли поставлен конец страницы. 
поооооовннвозввожожжвишны 
Примечание Чтобы увидеть скрытый текст, надо активизировать режим про- 
смотра скрытого текста в своем текстовом редакторе. Например, в Мсго- 
5ой ога 2000 выберите в меню Тоо|5 (Сервис) команду Орйоп$ (Пара- 
метры) и на вкладке У1еу (Вид) и установите флажок АП (Все) в секции 
Рогта те Магк$ (Знаки форматирования). 


3. Вставьте сноски для оглавления. Оглавление (ТаЫе оЁ Сошеп(5) — первая 
страница нашей справочной системы. Откройте в текстовом редакторе секцию 
сносок и вставьте перед заголовком тематического раздела следующие сноски 
(00110165) с такими метками: 


Метка Текст сноски Описание 
# НШ_СОМТЕМТ$ Идентификатор контекста справки 
$ У МРГЕ Нер Согиепи$ Заголовок тематического раздела 


НЯ Е р 2 ННИКНЕО Е ОЛА НЕРОН ООДЕНан 
После этого документ должен выглядеть, как показано на рисунке ниже. 
4. Вставьте сноски для страницы Тор/с 1. Тор!с 1 — вторая страница создава- 
емой системы. Вставьте следующие сноски с метками: 


Метка Текст сноски Описание 

# НШ_ТОРС1 Идентификатор контекста справки 
$ У1МРГЕ Не "орг 1 Заголовок тематического раздела 
к $1МРГЕ Тор!с$ Ключевые слова 


Ым——Ш 
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| 2 випр!е.г Г - Мегозой Мог 


вре „Нер- “ТаЫе: соай 


1 
Нер\юр1с$$ 
атом 


ЯНШ_СОМТЕНТЗ1 


МР Е’Неф`Сощетя 


ыы 


5. Дважды продублируйте страницу Тор1с 1. Скопируйте раздел Тор!с 1, вклю- 
чая маркер конца страницы, в буфер обмена и вставьте в документ две его копии. 
Вместе с текстом скопируются и сноски. В первой копии замените все цифры 
1 на 2, во второй — на 3. Не забудьте изменить и сноски. В ога бывает труд- 
но сразу определить, к чему относится каждая сноска, так что будьте внима- 
тельны. Документ, включая сноски, после этой операции должен выглядеть так: 


шаре: Нер-Тае- оБСошеньф 


1 

Нер“\ор:с$1 

Торе 1 нто_ тОРс11 
Торе-2Н_ТОР!С21 


15-15 Вечех Юг" РВ Чор1с-пилиь ег-1.4 
„раро тем 


КНер-Тор!с- р 
1 


Тыз-з-Вечехе-ог-Вер\ор1с-пиибег2.1 


ЖЕНЫ Тор!с:34 
1 


Трз-15еЧехе юг-Ве!р{ор!с-питабег-3.1 


ЗУМРИЕ Не Торе] 
КМРЕЕ Торез 
®НШ_ТОР1С31 
$УЭ1МРИЕ: Не Тор 31 
К УПМРЬЕ Тор:с81 
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6. 


7: 


Сохраните документ в файле \усрр32\Ех19а\$ипрГе.гЕ. В качестве типа 
файла выберите Е1сВ Техе Еогплае. 

Подготовьте файл проекта справочной системы. В \У!50а| С++ МЕТ или 
другом текстовом редакторе создайте файл \усрр32\Ех19а\5иар!е.Вр] с текстом: 


[ОРТТО№] 
СОМТЕМТ$=НТО_СОМТЕМТ$ 
ТГТЕЕ=УТМРЕЕ Арр11сат1оп Не]р 
СОМРВЕЗ $ ={ гие 

МАВМТАМС=2 


[ЕТЕЕЗ] 
эаир1е. гЕР 


Файл определяет идентификатор контекста справки для оглавления и имя 
ВТЕ-файла с текстом справки. Сохраните файл в текстовом формате (А$СП). 
Соберите справочный файл. Запустите в \/п4о\/з утилиту Мсгозой Нар 
У/огкзВор (НСКТЕехе) (она обычно хранится в каталоге Ргозгат ЕЙез\Мисгозой 
У15ща! За ю\Соттоп\Тоо15). Откройте файл \усрр32\Ех19а\$иаре.Вр} и щелк- 
ните команду Сотрийе из меню ЕЙе. Запустится УЛп4оу\/; Нер Сотрийег с фай- 
лом проекта $иар!е.Вр}. Компилятор сформирует справочный файл $ипр!е.р 
в том же каталоге. 

Запустите У1тНе!р с новым справочным файлом. В \Ип40%5 Ехрогег 
дважды щелкните файл \усрр32\Ех19а\5иар!е.Шр. Страница оглавления долж- 
на выглядеть так: 


| Заре Неф ТаЫе оЁ Сотет 


| Нер юр!сз 
. Торе 1 
т 


Теперь переместите указатель мыши на строку Тор 1 и обратите внима- 
ние, как меняется сего форма: из стрелки он превращается в кисть руки с «ука- 
зующим перстом». Щелкните левую кнопку — откроется страница Торис 1 (см. 
первый рисунок на след. странице). 

Текст НШД_ТОРС1 в оглавлении связан с соответствующим идентификато- 
ром контекста (сноска #) на тематической странице. Эту связь называют так- 
же переходом (дитр). 

Щелчок Торг 2 вызывает на экран всплывающее окно (см. второй рисунок 
на след. странице). 
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| > &МРЕЕ Аррисаноп Нар 


| Нер Торе 1 


> Тв 15 Ше 1ехё ог Вер торс пииег 1. 


Знир!е Неф ТаЫе оЁ Сощет 


| Нер юр:сз 
: Торе 1 
до 


Нер Торе 2 


Тьз 15 Че ЧехЕ Рог Вер 1ор1с шитбег 2. 


10. Щелкните кнопку Сош{еп{$ в \У4пНе!р. Должна открыться страница оглав- 
ления (см. п.9). Программе УЛпНер известен идентификатор этого экрана, 
поскольку вы определили его в НР]-файле. 

11. Щелкните кнопку [ладех в Ул Не!р. ХЛпНе!р откроет диалоговое окно шаех 
со списком ключевых слов в данном справочном файле. В нашем файле (5ипр- 
1е. р) во всех тематических разделах (кроме оглавления) только одно ключе- 
вое словосочетание — $ МРГЕ Тор!с$ (сноски К). Дважды щелкнув его, вы уви- 
дите связанные с ним тематические разделы (сноски $). 


У МРЕЕ Нер Торе 2 
`УМРИЕ Нер Торе 3 


416 Часть !! Архитектура «документ-вид» в МЕС 
До 


То, что мы получили, называется двухуровневой системой поиска справоч- 
ной информации. Пользователь может ввести первые несколько букв ключе- 
вого слова и выбрать тему из списка. Чем тщательнее вы подберете ключевые 


слова и названия тематических разделов, тем эффективнее будет ваша спра- 
вочная система. 


Совершенствование оглавления 


Оглавление, которое мы только что подготовили, сегодня считается старомодным. 
Последняя версия УЛаНер для \/п32 позволяет создавать современное оглавле- 
ние с древовидной структурой. Все, что для этого нужно, — текстовый файл с 


расширением СМТ. Добавьте в каталог \усрр32\Ех19а новый файл эиар/е.спе с та- 
ким текстом: 


:Вазе $1тр1е. пр 

1 Нер 10р1с$ 

2 Тор1с 1=НТО_ТОРТС1 
2 Тор1с 2=НТО_ТОРТС2 
2 Тор1с З=НТО_ТОРТСЗ 


Идентификаторы контекста соответствуют содержимому справочного файла. 


Скомпилировав $итр/е.спе, при следующем запуске УЛаНер с файлом 5ипр!е.р 
вы увидите новое оглавление. 


Ё торе? 
| Торе 3 


‚ СМТ-файлы можно редактировать, используя НСКТЕ СМТ-файл не зависит от 
НР]- и КТЕ-файлов. Но не забудьте, обновив свои КТЕ-файлы, внести соответству- 
ющие изменения и в СМТ-файл. 


Каркас приложений и МИпНер 


Вы видели, что УЛпНер может работать как автономная программа. В то же вре- 
мя с ней может взаимодействовать каркас приложений, обеспечивая тем самым 
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вывод контекстно-зависимой справки в ваших программах. Вот как вкратце это 
происходит. 


1. При запуске МЕС АррИсаНоп У/12ага установите флажок Согиех!-зеп1уе Нер, 
а переключатель — в положение УЛпНер (а не НТМГ, Техо. 

МЕС АррИсацоп \/12агАа формирует в меню Нер вашего приложения элемент 
Нер Тор!с$ и создает один или несколько КТЕ-файлов, НР]-файл и командный 
файл, запускающий компилятор справочной системы Нер Сотшриег. 

Затем МЕС АррИсайоп У таг определяет Е1 как «быструю клавишу» и связы- 
вает ее и элемент Нер Тор!с$ меню Не!р с функциями-членами объекта основ- 
ного окна-рамки. 


№ 


ь-. 


> 


Когда пользователь нажимает клавишу Е1 или выбирает команду меню Нер 
Тор!сз, программа вызывает УЛпНе]р, передавая ей идентификатор контекста, 
определяющий, какой именно раздел справки показать на экране. 


Теперь разберемся, как вызвать УЛюНер из программы и как последняя гене- 
рирует идентификаторы контекста для \шНе]р. 


Вызов \МУтНер 


Функция-член Старр: ИтНер активизирует \шНе!р из приложения. Заглянув 
в интерактивную документацию, вы увидите длинный перечень операций, конт- 
ролируемых необязательным (вторым) параметром функции ИмНерр. Мы не ста- 
нем его использовать и будем считать, что у ИмНер есть только один параметр — 
ашрейа типа ипзвпеа 1опв пи. Он задает справочные темы. Пусть у нас есть спра- 
вочный файл $ МРТЕ, а в нашей программе есть оператор: 


АРхбетАрр()->М1пНе1р(НТО_ТОРТС1); 


После его исполнения (в ответ на нажатие клавиши Е! или другое событие) 
появляется страница Тор!с 1 справочной системы — как если бы пользователь 
выбрал этот раздел в оглавлении. 

«Постойте-ка, — заметите вы, — а откуда УЛпНе]р знает, какой справочный файл 
взять?» Дело в том, что имя справочного файла соответствует имени программы. 
Например у программы с исполняемым файлом Зиар!е.ехе справочный файл на- 
зывается 5ипр!е.Шр. 


Примечание Можно заставить УЛпНе!р использовать другой справочный файл, 
записав нужное значение в переменную-член 172 _р52НерЕйеРер класса 
СУтаАрр. 


«А как УЛпНе!р связывает константу НШ_ТОР/С1 с идентификатором контек- 
ста справочного файла?» — спросите вы. Файл проекта справки должен содержать 
раздел МАР, в котором идентификаторы контекста увязаны с конкретными чис- 
лами. Если в файле гезоигсе.В приложения Н_ТОРС! определен как 101, то раздел 
МАР файла зипр/е.Нр] выглядит так: 


[МАР] 
НТО_ТОРТС1 101 
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Имена констант (заданных в программе операторами #ае/те) не обязательно 
должны совпадать с идентификаторами контекста — главное, чтобы совпадали их 
численные значения. И все же соответствие имен считается в программировании 
хорошим тоном. 


Поиск строк 


В программе, оперирующей с текстом, может понадобиться поиск справки по 
ключевому слову, а не по числовому идентификатору контекста. В этом случае 


используйте необязательный параметр НЕЁР_КЕУ или НЕГР _РАКПАГКЕУ функции 
утНер: 


С$1г119 $г119("Р1п9 111$ $г1п0”); // ищем эту строку 
АРХх@етАрр()->\1пНе1р( (ОМОВО) (ЕРСУТВ) з%г1пд, НЕЁР_КЕУ); 


Двойное приведение типа для 5йте необходимо потому, что первый параметр 
утНер — многоцелевой; его смысл зависит от значения второго параметра. 


Вызов \МтНер из меню программы 


МЕС АррИсаНоп УЛгагА генерирует в меню Нер элемент Не!р Тор!с$, сопоставляя 
его функции С\па::ОпНефрЕтает в основном окне-рамке, которая обращается к 
\УЛпНе так: 


АРГхбетАрр()->М1пНе1р(оЕ, НЕЕР_ЕТМОЕВ):; 


При этом вызове \ЛаНер отображает страницу оглавления, позволяя пользо- 
вателю перемещаться по файлу справки при помощи переходов и поиска текста. 
Если вы хотите получить «старомодное» оглавление, напишите: 


АРхбетАрр()->\4пНе1р(01, НЕЕР_ТМОЕХ): 
А если вам нужна справка по работе со справкой, вызовите: 
АГхбетАрр()->М1пНе1тр(о0Е, НЕЁР_НЕЕРОМНЕЕР); 


НЕГРОМНЕГР — стандартный идентификатор, требующий отобразить справ- 
ку по работе с самой справочной системой, однако он работает только при на- 
личии файла УЛ р52.Шр. 


Синонимы контекстной справки 


Раздел АМА$ в НР]-файле позволяет отождествлять разные идентификаторы кон- 
текста. Допустим, в вашем НР]-файле есть операторы: 


ГАЕТАЗ] 
НТО_ТОРТС1 = НТО_СЕТТТАМ_ЭТАВТЕО 


[МАР] 
НТО_ТОРТСЛ 101 


Тогда в КТЕ-файлах идентификаторы НШ_ТОРС!1 и НШ_СЕТИМС $ТАКТЕР 
взаимозаменяемы и оба связаны с контекстом справки 101. 


ГЛАВА 19 Контекстно-зависимая справка 419 


Определение контекста справки 


Теперь вы уже знаете, как создать в МЕС-программе простую контекстно-зависи- 
мую справочную систему. Вы определяете Е1 как «быструю клавишу» (в МЕС-биб- 
лиотеке это стандартная клавиша для вызова контекстной справки) и пишете 
обработчик команды, связывающий контекст справки с параметром функции 
утНер. Можно было бы придумать свой способ сопоставить состояние программы 
контекстному идентификатору, но отчего не воспользоваться преимуществами 
системы, уже встроенной в каркас приложений? 

Каркас приложений определяет контекст справки на основе идентификатора 
активного элемента программы. К последним относятся команды меню, окна-рамки, 
диалоговые и информационные окна, а также элементы управления. Элемент меню 
можно идентифицировать, скажем, как /)_ЕП/Т_СТЕАКАМ, а у основного окна-рамки 
обычно идентификатор ИК_МАИМЕКАМЕ. Можно было бы ожидать, что все эти 
идентификаторы прямо связаны с контекстами справки. А если идентификаторы 
команды и окна-рамки имеют одно и то же численное значение? Очевидно, та- 
ких накладок лучше как-то избежать. 

В каркасе приложений эта проблема решается путем определения нового на- 
бора #аейте-констант справки производных от идентификаторов программных 
элементов. Эти константы представляют собой сумму идентификаторов программ- 
ных элементов и определенных базовых значений. 


Префикс Префикс Базовое 

идентифи- элемента значение 

катора контекста (шестнадца- 
Элемент программы элемента справки теричное) 
Элемент меню или кнопка панели ШР,ШРМм НШО,НРМ 19000 
инструментов 
Окно-рамка или диалоговое окно ШК, РО. НШК,НШр_ 20000 
Окно сообщений об ошибках ЮР: НШОР_ 30000 
Неклиентская область Е 40000 
Элемент управления ШУ_ НШУ_ 50000 
Сообщения об ошибках диспетчеризации 60000 


НШ_ЕРТ СТЕАВАЦ, (0х1Е121) соответствует Ш_ЕРТГ_СТЕАВАЦ, (0хЕ121), а 
НШЕ_МАШЕВАМЕ (0х20080) — ШОВ_МАТМЕВАМЕ (0х80). 


Вызов справки клавишей [1 


В МЕС-программу встраиваются еще два способа доступа к контекстно-зависимой 
справке; они доступны при установке в МЕС АррИсайоп УЛ2ага флажка Согиех!- 
зепзшуе Не!р. Первый способ — стандартный вызов справки при нажатии клави- 
ши Е1. Пользователь нажимает ее, а программа, определив контекст справки, вы- 
зывает УЛпНе!р. Этот способ позволяет задать вывод справки об элементе меню, 
выбранном с клавиатуры, или о текущем окне (рамке, представлении, диалоговом 
или информационном окне). 
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Вызов справки сочетанием клавиш ЗЫ +21 

Второй способ вывода контекстно-зависимой справки предоставляет больше воз- 
можностей, чем первый. В нем программа различает такие контексты справки: 
элемент меню, на который указывает указатель мыши; 

кнопку на панели инструментов; 

окно-рамку; 

окно представления; 

конкретный графический элемент в окне представления; 

строку состояния; 


различные неклиентские элементы такие, как команды системного меню. 


Примечание Справка по нажатию ЗМЁ+Е1 не работает с модальными диало- 
говыми и информационными окнами. 


Пользователь активизирует такую справку, нажимая сочетание клавиш ЗЫ +Е1 
или щелкая кнопки СогехЕ Не на панели инструментов. В любом случае указа- 
тель мыши меняет свою форму на значок со знаком вопроса. При следующем 
щелчке появляется справка контекста, определяемого по позиции курсора. 


Справка в информационном окне: функция АЁхМеззадеВох 


Глобальная функция АхМезавеВох выводит сообщения об ошибках, формируе- 
мые каркасом приложений. Она аналогична функции-члену С\иа::МеззавеВох, но 
как дополнительный параметр получает идентификатор контекста справки. Кар- 
кас приложений сопоставляет его идентификатору контекста \ИпНер и вызыва- 
ет УЛаНе]р, когда пользователь нажимает клавишу Е1. Если вы хотите указать упо- 
мянутый параметр А/хМеззавеВох, имейте в виду, что соответствующие идентифи- 
каторы должны начинаться с ПОР_, а контексты справки в ВТЕ-файле — с НЮР. 

Существует два варианта А/хМе55авеВох. В первом строка подсказки определя- 
ется параметром — указателем на символьный массив. Во втором (с ним программы 
работают эффективнее) параметр — идентификатор подсказки определяет стро- 
ковый ресурс. У обоих вариантов АхМез5авеВох есть параметр «стиль», заставля- 
ющий показывать в информационном окне восклицательный или вопроситель- 
ный знак либо иной графический символ. 


Стандартные разделы справочной системы 


При установленном флажке Сотех(-зепзшуе Нер мастер МЕС АррИсаноп УЯтага 

формирует справочные разделы, связанные со стандартными элементами МЕС- 

программы: 

Ш стандартные команды меню и кнопки на панели инструментов (Ее, Еай и т. п.); 

Ш нсклиентские элементы окна (кнопка развертывания окна, строка заголов- 
ка ит. д.); 

Ш строка состояния; 

Ш окна сообщений об ошибках. 
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Справочные разделы по этим элементам содержатся в файлах АЁхСогели и 
АЕХРИПЕИЕ, размещаемых вместе с соответствующими файлами растровых изоб- 
ражений в подкаталоге НГР проекта. Ваша работа — адаптировать эти файлы в 
соответствии с требованиями к вашей программе. 
И 
Примечание МЕС АррИсаноп УЛгага генерирует АЁЕХРипе Е, только если уста- 

новлен флажок РипИпз апа рипе ргемеуу. 


Пример создания справочной системы без 
программирования 


Работая над программой-примером Ех184 в главе 18, вы устанавливали флажок 

Сотех(-зепзшуе Нер в МЕС АррНсаНоп \/2ага. Вернемся к тому примеру и ис- 

следуем «справочные» возможности, встроенные в каркас приложений. Вы уви- 

дите, насколько легко связать справочные разделы с идентификаторами команд 
меню и ресурсов окна-рамки. Мы отредактируем ВТЕ-, а не СРР-файлы. 

1. Проверьте правильность построения справочного файла. Если вы уже 
собрали проект Ех184, то велика вероятность, что справочный файл уже со- 
здан в ходе процесса сборки. Проверьте это, запустив приложение и нажав 
клавишу Е1. Вы должны увидеть стандартный экран АррИсаноп Нерр с заголовком 
«Моуша фе Роситепь: 


| Модйутд ве Зоситеги 


| << \/1е аррИсейоп-зресйс пе|р Пете {па ргомдез ап омегие\ оЁпо\ Пе изег Ноа 
| мобйу а Чоситег! из та усиг аррИсаноп. 


| Нуоигаррисайоп зирройз ти! р!е доситепНурез ап4 уси мапНо паме а зп пер 
:] орс\огеасй, (пеп изе пе пер сомех О депегеиед Бу шило пе МАКЕНМ аз ЮПоме: 


такейт ОР_НОА_,0х2000 гезоигсе.И 


|| ве ЮВ_ зутьоН‘ог опе огуоиг ЧоситепНурез 13, огехатр!е, ОВ_СНАРТ ТУРЕ, еп | 
| Че пер сомех О депегаей Бу МАКЕНМ м! Бе НОР_СНАВТТУРЕ. 1 


‚| Мое: Те аррИсайоп мага Чеёпез ‘ие НОР_ООСТТУРЕ пер сомех О изед Бу 5 
| парорсогве #51 ЧоситепИуре зирройед Бу усиг аррИсайоп. Тне аррйсайоп мигага | 
‚| ргодисез ап айаз м ‘ве „Нр] Ме гогуоцг аррйсайоп, таррта НОР_ООСТТУРЕ 10 фе 

] НОА_ ргодисед Бу МАКЕНМ юга! Чоситет уре. >> 


Если вы не увидели такого окна, значит, справочный файл создан некор- 
ректно. Соберите приложение повторно, запустите Ех184 и вновь нажмите Е1. 


2. Проверьте стандартный справочный файл. Проведите эксперименты. 


С Закройте диалоговое окно справки и нажмите сочетание клавиш АН-+Е а затем 
Е1. Должно открыться окно со справочным разделом о команде Ме\ из меню 
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ЕШе. Удерживая указатель мыши на команде М№е\м\ меню ЕЦе и нажав клави- 
шу Е1, вы должны увидеть ту же страницу справки. 

Закройте окно справки, нажмите кнопку Сопехи Не!р на панели инструмен- 
тов и выберите из меню ЕЦе команду $ауе. Открылся ли соответствующий 
раздел справки? 

Снова нажмите кнопку Согиехе Нер на панели инструментов и щелкните 
строку заголовка окна-рамки. Вы должны получить справку по заголовкам 
окон в УЛп4о\5. 

Закройте все дочерние окна и нажмите Е1. Вы должны увидеть основную 
страницу предметного указателя, которая представляет собой «старомодное» 
оглавление. 


3. Измените заголовок приложения. В файле АЁхСоге.гИ (в каталоге \усрр32\ 
Ех18А\Шр) есть несколько строк <<УоитАрр>>. Замените их повсюду на Ех18а. 

4. Отредактируйте раздел Мо4у1пе Те РоситепЕ справочной системы. 
Этот текст хранится в файле АЁхСоге.ли (каталог \усрр32\Ех18а\Шр). Найдите 
раздел Морутв Тре Роситет и замените его. текст своим, подходящим для 
вашего приложения. Идентификатор контекста справки у этого раздела — 
НШК_РОСТТУРЕ. Сгенерированный файл ех204.6р} предоставляет синоним 
НШК_Ех18АТУРЕ. 

5. Добавьте раздел для команды Ме 5$иае УЛа4о\ в меню УЛадо\. Эта 
команда добавлена в Ех184 нами, и поэтому для нее нет справочного текста. 
Введите нужный текст в АЁхСоге.г(Ё 


Мечи Эта соттапа (МИ пом! тепи) 


зе 115 соттапа 10 ореп а пему $пд уп Чому у {Не загпе сопЕег($ аз Ме асЁ\е улпдому. 
Уси сап ореп тийр!е досиглеп мупдоууз {0 @зр/ау Чегет райз ог Мемуз ога доситепеа Не 
зате те. УМлеп уоц ореп а пе\ уипаом, & Бесотез Ше асНуе уипоуу апа {5 4 р!ауед оп {ор 
о а! оЁНег ореп улпаому$. 


#Мем! Нех соттапа (Мп ом тепи) 


зе №15 согпгпапа 10 ореп а пему пех мипдо\/ ий 1Не зате согиег!з аз не асбуе уипдому. Уи 
сап ореп пи@р!е ЧоситепЕ уп 9омуз 10 @зр!ау Ч егепЕ рагЁз ог \емуз оЁ а ЧоситепЕ а йе 
зате цте. еп уси ореп а пеми \/п9оуч, & Бесогпез {Не асвуе уипдому апд 15 45рМауе4 оп ор 
ор а! оЁпег ореп \йп9ому$. 


-..Раде Вгеак- 


. 
е 
* НР_МИМРОУ!_НЕМЗТЕНСМИМРО 
# Н._УНРОМ_МЕМЖНЕХУЙНРОМ 


# НР_УИНРО\!_САЗСАРЕ 


Не забудьге о сноске #, связывающей раздел с идентификатором контекста 


НШ_УЙМРОЙ_МЕМ_5ТЮШМС, определенным в Шр\Ех18 4.61. Элемент меню М№е\у 
Уаз УЛпаох, конечно же, имеет идентификатор команды 2_ИМРО\ МЕУ- 
УТЮМОСМЛМРОУ. 

6. Соберите и протестируйте приложение. Пересоберите приложение, что- 
бы синхронизировать файлы справки. Проверьте две новые ссылки в справке. 
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Обработка команд вызова справки 


Итак, вы увидели, из каких компонентов состоит справочный файл и как действуют 
клавиша Е1 и сочетание ЗЫ Ё+Е1. Вы знаете, как идентификаторы программных 
элементов связаны с идентификаторами контекста справки. Однако внутренние 
механизмы обработки команд запроса справки каркасом приложений мы пока не 
обсуждали. А нужно ли это? Хм, представьте себе: вы хотите дать справку о каком- 
то окне представления (а не об окне-рамке) и собираетесь связать справочные 
разделы с теми или иными графическими элементами в’данном окне. И это, и 
многое другое можно реализовать, только переопределив функции, отвечающие 
за обработку команд в меню Не. 

Такая обработка зависит от того, как запрошена справка: по нажатию Е1 или 
УЫИ+Е1. Рассмотрим их обработку по отдельности. 


Обработка клавиши 21 


Клавишу Е1 обычно обрабатывает команда, указанная в соответствующей записи 
таблицы быстрых клавиш, которую МЕС АррИсайоп \/гата вставляет в ВС-файл. 
Клавиша Е1 сопоставляется команде П)_НЕГР, а та — функции-члену ОпНе/р клас- 
са СЕгате\па. 


Примечание Вактивном модальном диалоговом окне или в процессе выбора 
из меню клавиша Е1 обрабатывается У/п4о\5-ловушкой, которая вызы- 
вает ту же функцию ОпНерр. В противном случае быстрая клавиша Е1 была 
бы заблокирована. 


Функция СЁЕгате\па.:ОпНер посылает МЕС-сообщение УМ_СОММАМРЬНЕЕР 
внутреннему окну на самом нижнем уровне вложения — это обычно окно пред- 
ставления. Если в классе «вид» нет обработчика этого сообщения или обработчик 
возвращает ЕА/5Е, каркас приложений направляет сообщение вверх следующему 
по иерархии окну (как правило, это дочернее окно-рамка МПГ или основное окно- 
рамка). Если в ваших производных классах окон-рамок не определены обработ- 
чики ИМ_СОММАМОНЕГР, сообщение обрабатывается в МЕС-классе СРтате\па. Он 
отображает справку для символа, который определил МЕС АррИсаНоп ЖИтага для 
вашего приложения или типа документа. 

Если вы определили обработчик М СОММАМОНЕР в производных классах, 
ваш обработчик должен вызывать СУтАрр: ИтНер с корректным идентифика- 
тором контекста в качестве параметра. 

Для любого приложения МЕС АррИсайоп \/хагА добавляет к проекту символ 
К_МАПУЕКАМЕ, а НМ-файл определяет идентификатор контекста справки Н/ОК_ 
МАШМЕКАМЕ, который сопоставляется с тат_таех в НР]-файле. Стандартный файл 
АЁхСоге.т( ассоциирует основной предметный указатель с этим идентификатором 
контекста. 

Например, для МОТ-приложения ЗАМРГЕ мастер МЕС АррИсайоп У/Лтага вне- 
сет в проект символ П2К_ЗАМРГЕТУРЕ, а в НМ-файле определит идентификатор 
контекста НК_ЗАМРЕЕТУРЕ, сопоставляемый в НР]-файле символу НЮ РОСПУРЕ. 
Стандартный файл АЁхСогелг ассоциирует с этим идентификатором контекста 
страницу «МоЧНуте ше Воситепь. 
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Обработка сочетания клавиш ЗШ#+Е1 


При нажатии сочетания клавиш ЗМ Ё+Е1 или щелчке кнопки Сошехе Нейр на па- 
нели инструментов функция СЁЕгатепа::ОпСотехНер получает сообщение, свя- 
занное с соответствующей командой меню. Когда пользователь вновь делает щел- 
чок, поместив указатель на каком-нибудь элементе экрана, окну ниже по иерар- 
хии (из числа тех, где обнаружен щелчок) посылается сообщение УМ_НЕГРНИТЕЯТ. 
С этого момента маршрутизация сообщения происходит так же, как сообщения 
УМ_СОММАМРНЕГР (см. предыдущий раздел). 

Параметр /Ратат функции ОпНерНИ!е$1 содержит координаты мыши в едини- 
цах устройства относительно верхнего левого угла клиентской области окна. 
В старшем «слове» хранится координата у, а в младшем — х. Эти координаты по- 
зволяют указывать идентификатор контекста справки для конкретного элемента 
окна представления. Обработчик ОпНерНИ1ез! должен возвращать правильный 
идентификатор контекста; вызовом каркаса приложения займется утНнер. . 


Пример Ех19Б: обработка команд вызова справки 


Эта программа основана на примере Ех184 из главы 18 и представляет собой МП1- 
приложение с двумя окнами представления; в ее справочную систему добавлены 
разделы, относящиеся к каждому из этих окон. В каждом из двух классов «вид» есть 
обработчики сообщений ОпСоттапаНер (для Е1) и ОпНерНИТея (для комбина- 
ции 5МИ+Е1). 


Требования к заголовочным файлам 


Компилятор распознает особые идентификаторы для справки, только если при- 
сутствует оператор #тсшае: 


Нпс1иде <аРхри1м. > 


В Ех19Ь такой оператор имеется в файле ${ААЁХ.В. 


С$итаМем 
Классу, отвечающему за строковое представление документа, в уча \Меу.В нуж- 
ны прототипы функций таблицы сообщений для справки как по Е1, таки ЗЫЙ+Е1: 


атх_тз9 ГАЕЗУЕТ ОпСоттапане1р(МРАВАМ мРагат, ГРАВАМ 1Рагап): 
агх_тз9 ГВЕЗИЁТ ОпНе1рн1{Тез+(ИРАВАМ мРагат, (РАВАМ 1Рагат):; 


а в ао \Меу’срр — следующие записи таблицы сообщений: 


О№_МЕЗЗАСЕ (ИМ_СОММАМОНЕЕР, ОпСоттапаНе1р) 
О№_МЕЗЗАСЕ (ИМ_НЕЕРНТТТЕЗТ, Опне1рн1“Тез+) 


Функция-член ОпСоттапаНер в Зита \1еу’срр обрабатывает запросы справ- 
ки по Е1. Она реагирует на сообщение, присланное из основного окна-рамки МГУ, 
и отображает раздел справки для окна строкового представления: 


ГВЕЗУГТ  С$г1пд\1ем: :ОпСотталаНе1р(ИРАВАМ мРагат, ГРАВАМ 1Рагат) 
{ 


1 ОрРагам == 0) { // контекст еще не определен 
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1Рагат = НТО_ВАЗЕ_ВЕЗОЦАСЕ + ТОН_$ТВТМСУТЕМ; 
} 
АЁхбетАрр()->М1пНе1р(1Рагат); 
гефигп ТВИЕ; 


— 


Функция-член ОпНерНи!е$1 обрабатывает справку по ЗЫЯ+Е1: 


ЕВЕЗУЕТ С5г1пд\1ем: :ОпНе1рна{Тез{ (МРАВАМ мРагат, (ГРАВАМ 1Рагам) 


{ 
гетигп НТО_ВАЗЕ_ВЕЗОУАСЕ + ТОВ_ЗТАТМСУТЕМ; 


— 


1 


В более сложной программе может потребоваться, чтобы ОпНерНИТе$ уста- 
навливала контекст справки по позиции курсора. 


СНехМеи 


Класс СНехИеи обрабатывает запросы справки так же, как и класс Сия Ие. 
В Нех\еууВ обязателен код: 


аГх_т$9 1ВЕЗУЕТ ОпСотмапаНе1р(МРАВАМ мРагат, ГРАВАМ 1Рагап); 
атх_т59 ГВЕЗУЕТ ОпНе1рн1+Тез1(МРАВАМ мРагат, ГРАВАМ 1Рагап); 


Строки таблицы сообщений в Нех\У1еу’срр выглядят так: 


О№М_МЕЗЗАСЕ (ИМ_СОММАМОНЕЕР, ОпСоттапане1р) 
О№М_МЕЗЗАСЕ (ММ_НЕЕРНТТТЕЗТ, ОпНе1рн1*Тез+) 


И, наконец, код реализации в Нех\У1е\усрр: 


ЕВЕЗИЕТ СНех\1ем: :ОпСоттапаНе1р(МРАВАМ мРагат, 1РАВАМ 1Рагат) 
{ 
11 (ПРагат == 0) { // контекст еще не определен 
1Рагат = НТО_ВАЗЕ_ВЕЗОУВСЕ + ТОВ_НЕХУТЕМ: 
} 
АЁхбетАрр()->\М1ипНе1р(1Рагат); 
гетигпт ТВУЕ 


- 


|ВЕЗИЕТ СНех\У1ем: : ОпНе1рН1{Тез+ (МРАВАМ мРагам, ГРАВАМ 1Рагат) 


{ 
гетигп НТО_ВАЗЕ_ВЕЗОУВСЕ + ТОН_НЕХУТЕМ; 


—_ 


Требования к ресурсам 
В файл ресурсов добавлены два символа: 


Символ Значение _ Идентификатор контекста справки Значение 
ШК _5ТАМСИЕХ 101 НОЕ _5ТЫМСИЕЯ 0х20065 


Ш)К_НЕХИЕУ 102 НШК_НЕХИЕУ 0х20066 
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Требования к справочному файлу 


В файл АЁхСоге.гЕ добавлены два справочных раздела — с идентификаторами 
НЮК_5ТЫМСТЕУ и НШК_НЕХУЕУ. 


$аипя Мем 


ТН 15 Не пд ме\у оЕНе Чоситт 


ех ем 


Тре {5 пе Нехадесита| ме ое досигтеге. Е а!о\уз ргодгатигтегз 10 арргесгае пе роеху 


НТОВ_5ТЕЧСМТЕМ 
# НОЕ_НЕХЛЕМ 


Сгенерированный в подкаталоге НР проекта файл Ех19Б.Вт должен выгля- 
деть так: 


// Соттапдз (10_* апа ТОМ_*) 
НТО_ИТМООМ_МЕМНЕХИТМООМ 0х10082 
НТО_ИТМООМ_МЕМУТАТМСМТМООМ 0х10083 


// РготрЕз (ТОР_*) 
НТОР_ОГЕ_ТМТТ_РАТЕЕВ 0х30064 


// Везоигсез (ТОН_*) 


НТОН_МАМТЕЕЗТ 0х20001 
НТОН_МАТМЕВАМЕ 0х20080 
НТОН_Ех196ТУРЕ 0х20081 
НТОН_ЗТАТМОУТЕМ 0х20065 
НТОВ_НЕХУТЕМ 0х20066 


// 01а109$ (100_*) 
НТОО_АВОУТВОХ 0х20064 


// Егате Сопфго1з (Т0М_*) 


Тестирование приложения Ех19Ь 


Откройте дочерние окна со строковым и шестнадцатеричным представлением 
документа. Проверьте, как работает справочная система при нажатии клавиши Е1 
и сочетания клавиш ЗЫШЁЧ+Е1. 


МЕС и НТМЕ Нер 


В МЕС-приложениях обращение к НТМГ, Нар выполняется так же, как и к файлу 
УЛпНер. Приложение предоставляет контекстно-зависимой справочной системе 
идентификаторы справки, и она отображает окно с соответствующим разделом 
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справки. Однако файлы НТМЕ Нер скроены на иной лад — они скомпилированы 
из набора НТМГ-страниц, а не. из одного ВТЕ-файла. 
В таблице перечислены файлы, создаваемые мастером МЕС АррНсацоп УЙхага 


при выборе формата НТМГ, Нер для справочной системы. 


пианино 
Файл Описание 


НТМГОейпез.В Содержит идентификаторы контекста для всего проекта. 
Документы справки НТМГ-файлы с текстом справки — обычно один 

НТМЕ Нер на тематический раздел. 

<имя_проекта> Вс Файл для компилятора НТМТ, Нер. Содержит команды о том, 


как компилировать содержимое справки НТМГ, Нар. 


<имя_проекта> ВЬр Файл НТМЕГ, Нер для компилятора. Содержит директивы 
для компиляции содержимого справки НТМГ, Нар. 


Маш шаех.Вий НТМГ-файл верхнего уровня. Здесь добавляются тематические 
разделы справочной системы. 


Давайте поближе познакомимся с тем, как справочная система на базе НТМГ, 
Нер подключается к МЕС-приложению. 


Пример Ех19с: НТМЕ Нер 


Ех19с также основан на примере Ех184. Это МГ-приложение с двумя представ- 
лениями одного документа и поддержкой НТМГ, Не]р. Пример создан с помощью 
МЕС АррИсаНоп У/Л12агА и переключателем на странице Адуапсеа Ееагагез в поло- 
жении НТМЕ Нер Еоглав. 

В файле 64 штаош_пеияттвитаои т вы увидите измененный текст справки, 
относящийся к команде меню Ме\у $шше УЛпао\. Этот текст отображается при 
выборе контекстно-зависимой справки для команды Ме\м $ УЛааоу Обрати- 
те внимание и на новый файл 61 4_илт4ои_ пеифехрт (он не создан мастером МЕС 
АррИсайоп У/12ага) — это страница справки для команды Ме\ Нех У/пао\у. 

Если вы чувствуете в себе силы, можете изменять справочные файлы в Могераа. 
Файл содержит НТМГ-тэги, поэтому при достаточном умении редактирование не 
составляет труда. Однако лучше все-таки открыть НТМТ-файл в \1зиа! $а4ю МЕТ — 
она «понимает» НТМГ-файлы и заметно облегчает их редактирование. 

«А как вообще создать новые тематические разделы справки?» — спросите вы. 
Проще всего взять существующий НТМГ-файл, переименовывать его и заполнить 
нужным текстом. Затем новую НТМГ-страницу сопоставляют идентификатору ко- 
манды (06 этом ниже), 

В У15иа1 За о „МЕТ новые идентификаторы контекста справки добавляются при 
создании в программе новых команд меню и последующей ее компиляции. Где- 
то в начале файла НТМГОейпез.В вы найдете строки, определяющие контексты 
справки для команд меню Ме\м 5те УЛпао\ и М№е\у Нех УЛпао\: 


#аеР1пе НТО_МТМООМ_МЕМЗТВТМ6МТМООм 0х10082 
#9ет1пе НТО_МТМ00М_МЕМНЕХМТМООМ 0х10083 


В дополнение к стандартной справке для команды меню, созданной МЕС АррН- 
сацоп УЛгага, в Ех19с есть новый раздел для команды Ме\у Нех УЛпаох, Иденти- 
фикатор контекста справки заботливо предоставлен \1зиа! Зи о МЕТ в момент 
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создания команды меню. Теперь нужно его связать с файлом №4 илт4ош_пеш- 
Вехитаошит. Строка в Ех19с.ВНр файле сопоставляет идентификатор контекста 
справки с файлом: 


119_м1пдом_пемпехи1п9ом = 119_м1п90\_пемпехм1 пдом. Вт 


Наконец, файл Ех19с.ВВр содержит ссылку на новый НТМГ-файл в разделе 
[ЕШЕ$]: 


[ЕТЕЕ$] 
аРх_п1949_со1ог. Пт 
аРх_п199_111еореп. пм 
аРх_п199_#11езауе. пт 


019_м1пдом_пемзг1пдм1пдом. пт 
914_м1пдом_пемпехи1пдом. тт 
010_м1п90м_$р11{. м 


После создания связи НТМТ-файлов с идентификаторами справки по коман- 
дам меню ничего делать не нужно — справочная система заработает автоматически. 
Об этом позаботится сама МЕС. Чтобы убедиться лично, запустите программу Ех19с, 
последовательно выбирайте разные команды меню и нажимайте Е1. Вы увидите, 
как по нажатию Е1 открываются «правильные» страницы справки. 


ГЛАВА 


20 


Динамически подключаемые 
библиотеки 


Д инамически подключаемые библиотеки (Рупапус-Нак ИБгайез, РПГ.) остаются 
в основе компонентной модели Мсгозой УЛп4оу\’з даже в преддверии царства СГВ- 
среды М!сгозой МЕТ. Сама УЛтао\$ состоит из РИ.-библиотек, представляющих 
собой бинарные модули. Бинарная модульность отличается от модульности ис- 
ходного кода в С++. Вместо гигантских ЕХЕ-файлов, которые пришлось бы пере- 
страивать и тестировать при любом, даже самом незначительном изменении кода, 
гораздо эффективнее создавать компактные ОГТ-модули и тестировать их по от- 
дельности. Если, например, выделить в ОШ. какой-нибудь класс С++, то после ком- 
пиляции и компоновки объем модуля вряд ли превысит 12 кб. В период выполне- 
ния клиентские программы смогут очень быстро загружать и подключать ваши ОТ... 

Сегодня писать ПЛ, стало гораздо легче. В \/1п32 модель программирования 
резко упростилась, да и со стороны МЕС АррИсаНоп УЛтага и МЕС поддержка РМ. 
расширена и улучшена. В этой главе вы научитесь писать на С++ О-модули и 
клиентские программы, способные их использовать. Вы увидите, как \/п32 про- 
ецирует О, на адресные пространства процессов, и узнаете о различиях между 
обычными ПИ, МЕС-библиотеки (геошаг ОЛ.) и ОИ.-расширениями (ежепяюоп ОШ.). 
И, конечно же, мы рассмотрим простые примеры РИ, всех типов и даже более 
сложный пример РЦ, в которой реализован пользовательский элемент управ- 
ления (сизют сопио|. 


Основы О. 


Прежде чем обсуждать поддержку ОШ, каркасом приложений, надо разобраться, 
как \/1п52 интегрирует эти модули в процессы. Может, стоит даже вернуться к 
главе 10 и еще раз прочесть о процессах и о виртуальной памяти. Помните, что 


| 
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процесс — это выполняемый экземпляр программы, а программа запускается из 
ЕХЕ-файла на диске. 

В общем, Р.-модуль — это файл на диске (обычно с расширением ПИЛ), ко- 
торый состоит из глобальных данных, скомпилированных функций и ресурсов и 
становится частью вашего процесса. Он компилируется для загрузки по опреде- 
ленному базовому адресу; при отсутствии конфликтов с другими РИ. модуль про- 
ецируется на этот же виртуальный адрес в процессе. В ОШ, содержатся экспорти- 
Вуемые (ехропеа) функции, которые импортирует (ипрого клиентская программа 
(программа, загружающая О). Согласованием экспортированных и импортиро- 
ванных элементов занимается УЛпо\5. 
ани 
Примечание ПТТ-модули в \Х/1п32 позволяют экспортировать глобальные пе- 


ременные, не только функции. 
ОД ТЕ ИА 


В \У/п32 каждый процесс получает свою копию глобальных переменных РИ, 
доступных для чтения и записи. Чтобы несколько процессов совместно исполь- 
зовали какой-то участок памяти, надо либо прибегнуть к файлу, проецируемому 
в память, либо объявить общий раздел данных (зВагеа Чака зесНоп), как описано в 
книге Джеффри Рихтера. Всякий раз, когда ОИ, запрашивает память из кучи, эта 
память выделяется из кучи, принадлежащей клиентскому процессу. 


Согласование импортируемых элементов 
с экспортируемыми 


РИ. содержит таблицу экспортируемых функций. Эти функции идентифициру- 
ются по их символьному имени и (при необходимости) по целому числу — по- 
рядковому номеру (ог па! питег). В таблице функций хранятся также адреса 
функций в пределах ОГ... Впервые загружая ОЛ. клиентская программа не знает 
адресов нужных ей функций, зато знает их символьные имена или порядковые 
номера. Процесс динамической компоновки формирует таблицу, связывающую 
вызовы из клиентской программы с адресами функций в РИ. После модифика- 
ции РИ, собирать заново клиентскую программу не надо, если только вы не из- 
менили имен функций или последовательности их параметров. 
ники 
Примечание В простейшем случае вам хватило бы одного ЕХЕ-файла, импор- 
тирующего функции из одной или нескольких ОШ. Но в реальности 
многие РИ. в свою очередь вызывают функции из других РИ. Так что у 
каких-то 2, есть как экспортируемые, так и импортируемые элемен- 
ты. Но это не проблема — механизм динамической компоновки справ- 


ляется и с такими перекрестными связями. 
БПЩШЩЦЩ 


В коде РИ, экспортируемые функции надо объявлять явным образом, например: 
__9е61$рес(911ехрогЕ) 1пЕ МуРипс1оп(1пе п): 


Альтернативный способ — перечислить экспортируемые функции в файле 
определения модуля (РЕЕ) — гораздо хлопотнее. В клиентской программе надо 
указать, что функция импортируется: 
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__9ес1$рес(9111трог") 11 МуРипсЕ1оп(1пт п); 


Однако компилятор С++ сгенерирует для МуРипсйоп так называемое расши- 
ренное имя (аесогме4 пате), которое нельзя использовать в других языках. Это 
длинное имя составляется компилятором из имен класса и функции, а также ти- 
пов параметров. Такие имена перечислены в МАР-файле проекта. Для упрощения 
имени функции, скажем, МуРиисйоп, объявления следует писать так: 


ех+егп "С" __9ес1зрес(911ехроге) 1п МуРипс1оп(1п* п); 
ехфегп "С" __9ес1зрес(9111трогт) 11+ МуРипс1оп(1п* п); 


Примечание По умолчанию компилятор формирует передачу параметров по 
правилам __ с4ес1, а это значит, что параметры из стека выталкивает 
вызывающая программа. Программы на некоторых языках требуют при- 
держиваться правил _ $#сай (как в Разса!), когда стек очищает вызван- 
ная функция. Тогда в объявлении функции, экспортируемой из ОМ, 
понадобится модификатор __$1асай. 


Одних только объявлений импортируемых элементов недостаточно, чтобы 
клиент установил связь с Р.. В проекте клиентской программы надо определить 
библиотеку импорта (ШВ) для компоновщика, а сама программа должна содер- 
жать минимум один явный вызов какой-то функции, импортируемой из РМ. Опе- 
ратор вызова должен находиться на одном из путей выполнения программы'., 


Явное и неявное связывание 


В предыдущем разделе в основном описывалось неявное связывание (ипрИси 
Нок), которое программист на С++ скорее всего будет применять для своих РЫ.. 
Формируя РИ., компоновщик создает дополнительный ШВ-файл, содержащий 
символьные имена всех элементов, экспортируемых из РЕ. и (при необходимо- 
сти) их порядковые номера, но кода в нем нет. МВ-файл — это суррогат 2, до- 
бавляемый к проекту клиентской программы. Когда собирается клиентская про- 
грамма, импортируемые символьные имена согласуются с экспортируемыми из 
ИВ, и эти имена (или порядковые номера) сохраняются в ЕХЕ-файле. ИВ-файл 
содержит и имя ОИ.-файла (без указания пути), которое тоже хранится в ЕХЕ-файле. 
При загрузке клиента 90% находит и загружает нужные РЦ .-модули, а затем 
динамически связывает их по символьным именам или порядковым номерам. 

Явное связывание (ехр|си Попки?) больше подходит для интерпретирующих 
языков вроде Мисгозой ]3сйрь, но его можно использовать и в С++. При явном 
связывании файл импорта не нужен — вместо этого вы вызываете УЛп52-функ- 
цию Гоа тату, указывая полное имя РИ, как параметр. Гоаябгату возвращает 
параметр типа Ы/М5ТАМСЕ — его можно использовать в вызове СейтосАЧАте$з, 
преобразующей символьное имя (или порядковый номер) в адрес. Пусть РЦ. эк- 
спортирует функцию так: 


` Т.е. оператор вызова может и не выполняться, но должен находиться в таком месте 
программы, куда (пусть теоретически) может перейти управление. Только тогда ком- 
пилятор гарантированно сгенерирует машинный код, реализующий вызов. — Прим. 
перев. 
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ехтегп “С” __4ес15$рес(911ехрогЕ) доиб1е Заиагевоо+(аоиьле 4); 
Вот пример явного связывания клиента с экспортируемой функцией: 


Туредег доиб1е (50ВТРВОС) (дои61е); 

НТАМЗТАМСЕ ПТпзфапсе; 

ЗОВТРВОС» рЕипс+1оп; 

УЕВТРУ( АТпзфапсе = ::[оадЕ16гагу( "с: \\м1пп\\5узтет32\\туа11. 911”): 

\УЕВТРУ (рРипс®1оп = (ЗОАТРВОС*): : беРгосАдагезз ( (НМОВИЕЕ) АТпзфапсе, “ЗадцагеВоо{”)); 
Чоц61е 4 = (*рРипст10п) (81.0): // вызов функции из БЕ 


Если при явном связывании можно определить, когда загружать или выгружать 
РИ, то при неявном связывании все ОИ. загружаются в момент загрузки клиента. 
Явное связывание позволяет указывать и то, какие ОИ, следует загрузить. Напри- 
мер, пусть у вас есть одна РИ. со строковыми ресурсами на английском языке, а 
другая — со строковыми ресурсами на русском. Когда пользователь выберет язык 
для работы, приложение загрузит соответствующую РИ. 


Связывание по символьным именам и порядковым номерам 


Связывание по порядковым номерам в \/1п16 было эффективнее и предлагалось 
по умолчанию. В \/ 1132 связывание по символьным именам усовершенствовано, 
и теперь М1сгозой рекомендует именно его. Однако в ОМ--версии библиотеки МЕС 
применяется связывание по порядковым номерам. Дело в том, что типичная про- 
грамма на базе МЕС подключается к сотням функций этой библиотеки и при свя- 
зывании по порядковым номерам ЕХЕ-файл получается компактнее, так как от- 
падает необходимость хранить длинные символьные имена импортируемых эле- 
ментов. Если вы создаете РИ. со связыванием по порядковым номерам, опреде- 
лите в РЕЕ-файле проекта номера, которые не слишком часто используются в 
У/п32-среде. Если вы экспортируете функции С++, придется указывать в РЕЕ-файле 
их расширенные имена (или объявить функции как ежети «С»). Вот короткий 
фрагмент одного из РЕЕ-файлов МЕС-библиотеки: 


??0СВесептЕ11е1 1 зт@@ОАЕ@ТРВООННе7 @ 479 МОМАМЕ 
??0СВесогазет@@0АЕ@РАУСатаразе@@@7 @ 480 МОМАМЕ 
??0СНесога\1ем@@ТАЕ@Т@7 @ 481 МОМАМЕ 

??0СВесога\1ем@@ТАЕ@РВО@7 @ 482 МОМАМЕ 
7?0СВестТгаскегевоАЕ@РВИ+адВЕСТ@@Т@7 @ 483 МОМАМЕ 
??0СВе06)естевдАЕ@РАУСВ1 СПЕ 1+СпегТета@@7 @ 484 МОМАМЕ 
??0СВео6] ест@@ОАЕ@Х7 @ 485 МОМАМЕ 

7?ОСВезетРгорЕхспапде@@одАЕ@Х7 @ 486 МОМАМЕ 

2? 0СВ1спЕд1 {Сп гТ{ете@оАЕ@РА| гео] ест@@РАУСВ1свЕа1+00с@@@7 @ 487 МОМАМЕ 
??0СВ1спЕд1+Бос@@тАЕ@Х7 @ 488 МОМАМЕ 

7?0СВ1спЕд1{\/1ем@@0АЕ@Х7 @ 489 МОМАМЕ 

??0С$сго11У1ем@е@ТАЕ@Х7 @ 490 МОМАМЕ 

??0Сбетарпоге@воАЕ@.) /РВОРАЦ_ЗЕСИВТТУ_АТТАТВУТЕЗ @@@7 @ 491 МОМАМЕ 
??0С5ЗпагедЕ11е@@0АЕ@ТТ@7 @ 492 МОМАМЕ 


Числа после символов @ — это и есть порядковые номера. Ну что, вы по-пре- 
жнему хотите использовать символьные имена? 
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Точка входа в О: функция ОМат 


По умолчанию компоновщик предполагает, что основная точка входа в ОШ, — 
функция _ОИМатСКТЯатир. УИп9оу, загружая ОШ, вызывает эту функцию, а та 
сначала вызывает конструкторы глобальных объектов, потом — глобальную фун- 
кцию ОИМат, которая, естественно, должна присутствовать. ДИМат вызывается 
при подключении ОШ, к процессу, при отключении от него, а также в ряде дру- 
гих случаев. Взгляните на заготовку функции ОИМат: 


НТАЗТАМСЕ 9_НТпзфапсе: 
ехтегп “С” 111 АРТЕМТВУ 
011Ма1п( НТМЗТАМСЕ ПТпзфапсе, ОМОВО дмАеазоп, ЕРУОТО 1рВезегуед) 


11 (дмВеазоп == О: _РВОСЕ$$_АТТАСН) 

{ 
ТВАСЕО( “Ех20а. 01 1Тп1{1а1121п9!\п”); 
// 00 1п1{1а11та{1оп Пеге 

} 

е1зе 1Р (9мВеазоп ==-011_РВОСЕ$$_ОЕТАСН) 

{ 
ТВАСЕО (“Ех20а. 01 Тегтапат1п9! \п”); 
// бо с1еапир пеге 

} 

гефигп 1; // ок 


Если вы не пишете функцию ОИМа для своей РЦ, вместо нее подставляется 
версия-заглушка из стандартной библиотеки периода выполнения. 

Функция ОИМат вызывается также при запуске и завершении отдельных по- 
токов, что определяет параметр ЯиЖеа5от. Впрочем, эта сложная тема исчерпы- 
вающе изложена в книге Джеффри Рихтера. 


Описатели экземпляров и загрузка ресурсов 


Каждая РИ, в процессе идентифицируется уникальным 32-разрядным значением 
НИМУТАМСЕ. У процесса тоже есть описатель типа ЫИМ5ТАМСЕ. Все эти описатели 
экземпляров действительны только в рамках конкретного процесса и представ- 
ляют собой начальный виртуальный адрес ОШ- или ЕХЕ-модуля. В \У/п32 значе- 
ния описателей ШМУТАМСЕ и НМОБШЕ совпадают, и эти описатели равнознач- 
ны. Описатель экземпляра процесса почти всегда равен 0х400000, а у РЦ, с базо- 
вым адресом по умолчанию — 0х10000000. Если ваша программа работает с не- 
сколькими ОШ, у них будут разные значения НИ\У5ТАМСЕ, потому что в ОШ, указа- 
ны разные базовые адреса (определяется на этапе разработки) или потому что 
загрузчик скопировал и переместил код О. 

Описатели экземпляров особенно важны при загрузке ресурсов. В частности, 
параметр НИМ5ТАМСЕ необходим \/т32-функции ЕтаКебоитсе. В ЕХЕ- и РШ-мо- 
дулях могут быть свои ресурсы. Если нужен ресурс из РЦ, указывают описатель 
экземпляра ОИ, а если из ЕХЕ — описатель экземпляра ЕХЕ. 
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Как же получить описатель экземпляра? Вы уже видели, что описатель экземп- 
ляра РИ. передается как параметр в функцию РИМагт. Если вы хотите выяснить 
описатель ЕХЕ-модуля, вызовите \/п32-функцию СеМоашенаище с параметром 
МИЫ.. Если же нужен описатель ОШ, вызовите СеМоашеНнапае с именем РИ. в 
качестве параметра. Позже мы рассмотрим еще один метод загрузки ресурсов, 
реализованный в МЕС-библиотеке, основанный на просмотре модулей в опреде- 
ленной последовательности. 


Порядок поиска ОШ. клиентской программой 


Если вы компонуете программу явным образом, используя Гоатагу, то можете 
указывать полное имя ОМ. (с определением пути). Если же полный путь не ука- 
зан, а также при неявной компоновке У/п4оууз будет искать вашу ОЫ, в таком 
порядке. 

В каталоге, содержащем данный ЕХЕ-файл. 

В текущем каталоге процесса. 

В системном каталоге УЛпао\5. 

В каталоге У/ЛпЧо\. 


В 


В каталогах, определенных в переменной окружения РАТН. 


Здесь есть одна ловушка, в которую можно запросто угодить. Вы создаете О!Л, 
как отдельный проект, затем копируете ОИ .-файл в системный каталог Х/пао\$ 
и, наконец, загружаете РЫ.в клиентскую программу. До сих пор все было прекрасно. 
Но вот вы обновляете ПТ, забываете скопировать ее в системный каталог, и при 
следующем запуске клиентской программы загружается старая версия РИ. Что тут 
сказать — будьте внимательны! 


Отладка О: 


У!5иа! С++ упрощает отладку РИ. Просто запустите отладчик в проекте ПИ. При 
первом запуске отладчик запросит путь к клиентскому ЕХЕ-файлу, После этого при 
каждом «запуске» 2, из отладчика тот загружает этот ЕХЕ-файл, но в ЕХЕ-файл 
заложена своя последовательность поиска ОШ.-модулей. Это значит, что надо или 
настроить переменную окружения РАТН, или скопировать РИ, в каталог, который 
входит в последовательность поиска. 


ОЕ: -расширения и обычные ОЕ 


До сих пор мы рассматривали Р!Л.-модули \//п32, в которых есть функция ОИМат 
и какие-то экспортируемые функции. Теперь двинемся в мир, построенный на 
каркасе МЕС-приложений, расширяющем базовую УЛ п32-поддержку ОШ. МЕС 
АррИсаНоп УЛ2агА позволяет создавать два вида ОИ. с поддержкой МЕС-библио- 
теки: РИ -расширения (ежмепзюп РИ) и обычные ВИ, (герщаг 2Ы)). Но перед вы- 
бором надо вникнуть в суть предмета. 
в авиа 
Примечание Конечно, У15иа1 С++ МЕТ позволяет создавать \Лп32 РИ, без биб- 
лиотеки МЕС — так же, как и программы. Но эта книга посвящена МЕС, 
так что этот вариант нас не интересует. 
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РИ-расширение поддерживает интерфейс С++. Иначе говоря, такая ОШ. мо- 
жет экспортировать целые классы, а клиент может создавать объекты этих клас- 
сов или разрабатывать производные классы. ОШ.-расширение динамически свя- 
зывается с кодом ОШ.-версии библиотеки МЕС, поэтому клиентская программа 
должна компоноваться с МЕС тоже динамически (МЕС АррИсайцоп У/гагА предла- 
гает этот вариант по умолчанию), а у клиентской программы и О.-расширения 
должны совпадать версии динамических библиотек МЕС (пЕ42.А1, пЁс942.4Ш и 
т. д.). ОИ-расширения весьма компактны: можно создать простое ОИ.-расшире- 
ние размером всего 10 кб, которое загружается очень быстро. 

Если же вам нужна ОШ, которую можно загружать в любую УЛп32-среду про- 
граммирования, тогда вам нужна обычная РИ. Однако здесь есть одно большое 
«но»: обычная О, способна экспортировать только функции в стиле С и не под- 
держивает экспорт классов С++, функций-членов или переопределенных функ- 
ций, ведь в каждом компиляторе С++ свой метод расширения имен функций. 
Правда, в самой РЦ, этого типа можно использовать классы С++ (в том числе 
классы МЕС). 

Создавая обычную ОШ, вы можете решить, как связывать ее с МЕС-библиоте- 
кой: статически или динамически. Если вы выберете первое, в ОИ, будет включе- 
на копия нужного кода МЕС-библиотеки, и таким образом вы получите самодос- 
таточный ОШ .-модуль. Средний размер статически связанной ОМ, без отладочной 
информации — около 144 кб. Если же вы предпочтете второе, размер уменьшит- 
ся приблизительно до 17 кб, но при этом надо позаботиться о том, чтобы на ком- 
пьютере пользователя присутствовали необходимые динамические модули МЕС. 
Это не проблема, если клиентская программа уже динамически связана с той же 
версией МЕС. 

Когда вы сообщаете МЕС АррИсаНноп \/17ага, какой тип РМ, или ЕХЕ вам ну- 
жен, #4ейте-константы для компилятора устанавливаются так: 


ны 


Динамическое связывание — Статическое связывание 
с общей МЕС-библиотекой с МЕС-библиотекой 


Обычная РЫ, _АЕХБИ, _($КОИ. _0$КРЫ, 
ОИ.-расширение ‚ АЕХЕХТ, АЕХРИ, Не поддерживается 
Клиентская ЕХЕ-программа _АЕРХОМ, Константы не определены 


Заглянув в исходный код и заголовочные МЕС-файлы, вы увидите массу опе- 
раторов #4] для этих констант. Это значит, что библиотечный код компилиру- 
ется по-разному в зависимости от типа создаваемого проекта. 


ОН--расширения: экспорт классов 


Если ОИ.-расширение должно содержать только экспортируемые классы С++, 
создавать и использовать такую библиотеку легко. Описывая сборку Ех20а, мы 
расскажем, как сообщить МЕС АррИсайоп У/12ага, что нужно создавать В.-рас- 
ширение. Генерируемая мастером заготовка содержит лишь функцию ОИМат. Вы 
должны добавить в проект свои классы С++ и дополнить объявления классов мак- 
росом АЕХ_ЕХТ_С1455;: 


с1азз АРХ_ЕХТ_СЁА$$ С5тидепе : риуб11с СОБ]есе 
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Это изменение надо внести в заголовочный файл, часть РИ-проекта, и в ана- 
логичный файл, используемый клиентской программой. Иначе говоря, заголовоч- 
ные файлы клиента и ОМ, должны совпадать. Макрос генерирует код в зависимо- 
сти от ситуации: класс экспортируется из РИ, или импортируется в клиент. 


Последовательность поиска ресурсов в ОМ.-расширении 


Если вы создаете динамически связываемое клиентское приложение на базе МЕС, 
многие стандартные ресурсы МЕС-библиотеки (строки сообщений об ошибках, 
шаблоны диалоговых окон для предварительного просмотра перед печатью и др.) 
хранятся в ОИ -модулях МЕС, но и у вашего приложения есть свои ресурсы. Когда 
вы вызываете МЕС-функцию вроде С5тта:Гова тв или СВитар:ЛоааВйтар, 
каркас приложений ищет сначала ресурсы ЕХЕ-файла, а потом ресурсы РИ, МЕС. 

Если же программа включает в себя Р.-расширение, порядок поиска таков: 
сначала ЕХЕ-файл, затем ОШ.-расширение и, наконец, О, МЕС. При наличии, 
скажем, уникального идентификатора строкового ресурса МЕС-библиотека най- 
дет именно его, а если в ЕХЕ-файле и файле ОИ.-расширения какие-то иденти- 
фикаторы строковых ресурсов дублируются, МЕС-библиотека загрузит строку из 
ЕХЕ-файла. 

Если же ресурс загружает ОИ.-расширение, последовательность поиска другая: 
сначала ОШ -расширение, затем ОШ, МЕС и, наконец, ЕХЕ-файл. При необходимости 
последовательность поиска можно изменить. Допустим, вы хотите в ЕХЕ-коде 
сначала искать ресурсы РИ-расширения. Это можно сделать так: 


НТМЗТАМСЕ ПпТпз+ВезоигсеС11ет{ = АгхбетвезоигсеНапа1е(); 

// Используем описатель экземпляра ОЕ 
АГхЗетнезоигсеНапа1е( : : ве: Моди1еНапа]е ( “пуд11пате. 911"); 
С$1г1п9 з1гНез; 

ЗтгВез$. Гоа9$1г1п9(10$_МУЗТВАТМ6) 

// Восстанавливаем описатель экземпляра. клиентской программы 
АГхЗетВезоигсеНапа1е (пТпз+ВезоигсеС11еп*); 


Использовать здесь АбхсейпяапсеНапе вместо ::беМоащеНапа нельзя: в О. 
расширении АбхбейпяапсеНапа возвращает описатель экземпляра ЕХЕ-, анерЦ-- 
модуля. 


Пример Ех20а: ОН--расширение 


Мы превратим в РИ.-расширение класс СРегметЕгате из главы 14. Сначала 
вы создадите файл Ех20а.аИ, а потом используете его в клиентской программе 
Ех20Ь. Итак, создаем Ех20л. 


1. Средствами МЕС АррИсаЧоп У/12тага создайте проект Ех20а. Выберите в 
меню ЕЦе последовательно команды Ме\ и Ргодесе. В качестве типа приложе- 
ния выберите МЕС РИ, а в качестве имени — Ех20а. На странице АррИсаНоп 
5е118$ мастера установите переключатель О. 1уре в положение МЕС ехеп$юп 
ОГ: 
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МЕС ОН: МИгагд — Еи20а 


| Аррйсабоп 5е 19$ 
бресу {Не {уре ап Геавигез о! Не ОЦ., 


2. Просмотрите файл Ех20а.срр. МЕС АррИсаНоп У/гагА генерирует код, со- 
держащий функцию ОИМат: 


// Ех20а.срр : Ое!1пез {пе 1п111а117а{1оп гоу{1пез Рог пе ОЕ 
// 

#1пс1иде “эфдагх. п” 

#1пс1и40е <аРха11х. п> 


#1Г9ет _ОЕВУ@ 
#9еР1пе пем ОЕВУб_МЕМ 
вепда1Р 


$фа{1с АРХ_ЕХТЕМЗТОМ_МОВИЕЕ Ех20аб Е = { МЕ, М }; 


ехфегп “С” 1пЕ АРТЕМТАУ 
011Ма1п(НТМЭТАМСЕ НТизфапсе, ОМОНО дмВеазоп, ЕРУОТО 1рВезегуед) 
{ 


// Ветоме 111$ 1Р уси изе 1рВезегуед 
ОМВЕРЕВЕМСЕО_РАВАМЕТЕВ( 1 рВезегуеа); 


11 (9иВеазоп == ОЕЕ_РАОСЕ$$ _АТТАСН) 
{ 
ТВАСЕО( “Ех20а. ВЫЁ 1п111а1171п9! \п”); 


// Ехфепзлоп ОЕ опе-{1те 1п111а117а{1оп 
1 (!АРхХТи1Ехфептз1топМоди1е (Ех20абЕЕ, ПТпзтфапсе)) 
гетигп 0; 


(пропускаем сгенерированные строки комментариев) 
пем Суп 1пкЕЗ6гагу(Ех20абЕ а) 


} 
е1зе 1! (9мВеазоп == 01: _РНОСЕ$$_ОЕТАСН) 
{ 

ТВАСЕО(“Ех20а. 01: Тегтзпат1пд!\п”); 
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// Тегтапате {Ве 116гагу беРоге дезтгисфогз аге са11ед 
АРхТегтЕхфепз1опМоди1е(Ех20ар((); 
} 
гефигп 1; // ок 
} 


3. Добавьте в проект класс СРегу{епЕгате. Скопируйте файлы Рег. и 
Рег15.срр из папки Ех14а на компакт-диске. Щелкните в меню Рго]ес! коман- 
ду Ааа Ех5ипз Цет, в списке файлов выберите Регз15е.В и Рег$15.срр и щелк- 
ните кнопку ОК. 


4. Отредактируйте файл Рег$151.В. Найдите строку: 
с1а$$ СРег$1зтеп{Егате : риб11с СЕгатемпа 
и поправьте ее: 


с1азз$ АРХ_ЕХТ_С1А$З$ СРегз1зфептЕгате : риуб11с СЕгатемпа 


5. Соберите проект и скопируйте файл ОШ. Скопируйте Ех20а.А1 из катало- 
га \усррпе \Ех20а\РеБиз в системный каталог. 


Пример Ех20Ь: тестовый клиент ОМ.--расширения 


Эту программу мы начнем создавать как клиент для Ех20а.аП. Она импортирует 
из РИ, класс СРегя ет! тате и использует его как базовый класс окна-рамки $11. 
Позже вы добавите в нее код, который позволит загружать и проверять другие 
примеры РИ, из этой главы. 


1. Спопощью МЕС АррНсаНоп \/12аг4 создайте проект Ех20Ъ. Это обычная 
ЕХЕ-программа на базе МЕС. На странице АррИсаНоп Туре мастера установите 
переключатель в положение ше доситепе. Остальные параметры оставьте 
без изменения. Убедитесь, что переключатель 06 оЁ МЕС на странице АррИсаноп 
Туре установлен в положение 05е МЕС 11 а зВагеа ПШ. 

2. Скопируйте файл Рег$151.В из каталога \усррпе \Ех20а. Заметьте: копи- 
ровать надо заголовочный, а не СРР-файл. 

5. Замените базовый класс СМатЕгате на СРегуяеп!Егате, как это дела- 
лось в Ех14а. Проведите глобальную замену СЕгатепа на СРегяячеттате 
как в МашЕгт.В, так и в МатЕгта.срр, а также вставьте в МашЕгт.В строку: 


#1пс1и4е “рег$1$+. п” 


4. Добавьте библиотеку импорта Ех20а в список входных библиотек ком- 
поновщика. Выберите в меню Рго}ес( пункт Ааа Ех15 по Цет и в открывшемся 
окне найдите файл Ех20а.1Ь в каталоге \Ех20а\Рериз на компакт-диске. Щел- 
кните ОК, 

5. Соберите и протестируйте программу Ех20Ъ. Если при запуске програм- 
мы под отладчиком \Лп9о%уз не найдет Ех20а.АП, откроется окно с соответству- 
ющим сообщением. Если все пройдет благополучно, вы получите приложение 
с постоянной окном-рамкой, которое работает абсолютно так же, как и Ех14а. 
Все отличие в том, что код СРегепттате выделен в РИ.-расширение. 
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Обычные ОШ-.: структура АРХ_ЕХТЕМЗЮМ МОБИЕЕ 


Когда МЕС АррИсайоп УЛгагА генерирует обычную РИ, функция РИМат находится 
внутри каркаса приложений, а вы имеете дело с структурой типа АЕХ_ЕХТЕМ- 
5ЮМ_МОМЛЕ (и ее глобальным экземпляром). Во время инициализации О!Л.-рас- 
ширений АЁРХ_ЕХТЕМУОМ МОРОГЕ служит для хранения состояния О1.- модуля. 

Как правило, с этой структурой делать ничего не надо — вы можете создавать 
свои функции на С и экспортировать их модификатором __ аесбрес(@Йехрот (или 
создав записи в РЕЕ-файле проекта). 


Макрос АРХ_МАМАСЕ_$ТАТЕ 


Когда в процессе работы программы загружается пс 70.а1, она сохраняет данные 
в нескольких глобальных переменных. Если МЕС-функции вызываются из МЕС- 
программы или ОИ-расширения, т!С70.АП «знает», как установить эти глобаль- 
ные переменные для вызывающего процесса. Если же к п!Ес70.АЙ обратиться из 
обычной РИ, глобальные переменные не синхронизируются должным образом, 
и результат будет непредсказуем. Чтобы решить проблему, в начало каждой экс- 
портируемой функции данной ОШ, надо вставить строку: 


АРХ_МАМАСЕ_ЗТАТЕ( АРхбет5та+1сМоди1е тате()); 


Если же МЕС-код связывается статически, макрос не оказывает никакого влияния. 


Последовательность поиска ресурсов в обычной ОН 


Когда ЕХЕ подключает обычную РИЦ, функции загрузки ресурсов в ЕХЕ-модуле 
загружают ресурсы самого ЕХЕ-модуля, а функции загрузки ресурсов в РИ, — 
ресурсы этой ОГ. 

А вот чтобы код ЕХЕ-модуля загружал ресурсы из РШ., можно вызвать функ- 
цию 4/х5еЖезоитсеНапаЕ для временной смены описателя ресурса. Сам код прак- 
тически не отличается от приведенного в разделе, посвященном поиску ресурсов 
в РИ-расширениях. Если вы пишете приложение, требующее локализации, то 
можете поместить зависящие от языка строки, диалоговые окна, меню и т. п. в 
обычные РЦ, (например, в ЕпзИзВ.а!, Сегтап.а! и ЕгепсВ.а!). Клиентская программа 
явно загрузит нужную РИ, и использует упомянутый выше код для загрузки ре- 
сурсов, которые, кстати, должны иметь одинаковые идентификаторы во всех 2. 


Пример Ех20с: обычная ОЕ 


Мы создадим обычную ОШ, которая экспортирует единственную функцию вычис- 
ления квадратного корня. Сначала мы соберем Ех20с.а1, а потом изменим клиент- 
скую программу Ех20Ъ, чтобы протестировать новую ОШ. 

1. Средствами МЕС АррНсайоп \/12аг4 создайте проект Ех20с. Действуйте 
так же, как и в Ех20а, но в на странице АррИсаНоп $еп2$ установите пере- 
ключатель ОИ, гуре в положение Везшаг РИ, Озше 5вагеа МЕС РИ, а не МЕС 
ежепзюп ОИ. 

2. Просмотрите файл Ех20с.срр. МЕС АррИсаНоп УЛгага генерирует такой код: 
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// Ех20с.срр : Обег1пез {Не 1п141а117а*1оп гоиф1пез Рог +пе ОЕ 


// 
#1псТиде “зтдафх. п” 
#ис1иае “Ех20с. п” 


#1Гаег _ОЕВУв 
#9ег1пе пем ОЕВИб_МЕМ 
#епа1 т 


(пропускаем сгенерированные строки комментариев) 


// СЕх20сАрр 
| ВЕСТМ_МЕЗЗАСЕ_МАР(СЕх20сАрр, С\1пАрр) 
| ЕМО_МЕЗЗАСЕ_МАР() 


// СЕх2ОсАрр сопзфгис1оп 
СЕх20сАрр: : СЕх20сАрр() 
{ 
// 1000: ааа сопзфгис1оп соде пеге, 
// Р1асе а11 з1911Р1сапе 1п1{1а117а1оп 1п Тп1“Тизфапсе 


} 


// Тпе опе апа оп1у СЕх20сАрр об3ес+ 
СЕх20сАрр тпеАрр; 


// СЕх20сАрр 1п1{1а112а11оп 
ВООЕ СЕх20сАрр: :Тп1{Тпзтапсе() 
{ 

СИЗ пАрр: :Тп1{Типзтапсе(); 


гефигп ТВОЕ; 
} 


3. Добавьте код экспортируемой функции Ех20с$4диагеКоог. Этот код можно 
ввести как в Ех20с.срр, так и в новый файл: 


ехфегп “С” __9ес1$рес(911ехрог{) доч6Ле Ех20с$диагеВоо* (аоиь1е а) 


{ 
| АРХ_МАМАСЕ_ОТАТЕ( АРхбе{${а{1сМоди1етате()) 
| ТВАСЕ( "Епфег1пд Ех20с$диагевоо*\п”) 
ТР (4`>=0. 0) 
гефигп загт(а); 
} 
АгхМеззадеВох ("Сап’+ таке здиаге гооф ог а педат1уе питьег. "); 
// Нельзя извлечь корень из отрицательного числа 
| гефигп 0.0; 
} 


Как видите, проблем с выводом окон сообщений и других модальных диа- 
логовых окон в ОМ, нет. Не забудьте включить та.в в файл с кодом функции 
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Ех2Ос54иагеКос1. Кроме того, укажите прототип функции Ех20с5диатеКоой в 
файле Ех20с.В, чтобы она была видна внешним клиентам. 

4. Соберите проект и скопируйте файл О.. Скопируйте Ех20с.А1 из катало- 
га \Ех20с\РеБи$ в системный каталог. 


Коррекция Ех20Ь для проверки Ех20с.аИ 


Когда вы собирали программу Ех20Ь, она динамически связывалась с ОМ.-расши- 
рением Ех20а. Теперь мы изменим проект, чтобы неявно скомпоновать Ех20Ь с 
обычной РИ, (Ех20с) и вызывать из нее функцию квадратного корня. 


1. Добавьте новый диалоговый ресурс и класс в Ех20Ъ. С помощью редак- 
тора диалоговых окон создайте шаблон ШО_ЕХ20С: 


Затем средствами мастера Ааа С1а$5 УЯтагА сгенерируйте класс С7ё5120сПйщов, 
производный от СБйв. Элементы управления, переменные-члены и функция 


карты сообщений описаны в таблице: 
АЕ ЕЕ ни: 


Идентификатор Функция карты 
элемента управления Тип Переменная-член сообщений 

ШРС МРОТ Поле ввода т_@атриЁ (аонЫе) 

ШРС_ООТРИТ Поле ввода т_аОшри (аоиые) 

Ш)С_СОМРИТЕ Кнопка ОпВписйсвеаСотрше 


2. Напишите код функции ОиВиСИсвейСотрше, чтобы вызывать экспор- 
тируемую функцию ОМ... Отредактируйте заготовку функции в Те5{20с- 
01а10оэ.срр: 


\014 СТез{20с01а109: :ОпВпС11скедботрите( ) 
{ 
Урдафебата(ТВИЕ); 
т_Ч90ириф = Ех20с$диагевоо{ (м_9Тприт); 
Урдатерата(РАЕЗЕ); 


Объявите Ех2Ос5диатеКооЁ как импортируемую. Для этого добавьте в '1ез120с- 
П1а]оФ.В: 


ех{егп “С” __9ес15рес(9111трог+) дочб1е Ех20сЗацагевоо* (аои61е а); 


3. Введите класс СТе$120с[4108 в приложение Ех20Ъ. Добавьте меню верх- 
него уровня ТезЕ и команду Ех20с РИ, с идентификатором Ш_ТЕЗТ ЕХ20СРЫ. 
В окне Ргорегиез утилиты С1аз5 У1е\уу сопоставьте эту команду функции-члену 
класса СЕх2ОБМеи и напишите код обработчика в Ех2О0Б\е\..срр: 
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\019 СЕх206\1ем: :ОпТез{Ех20с911() 


{ 
СТез+20с01а109 919; 
919.00 Мода1(); 


И, конечно же, дополните файл Ех20Б\У1е\усрр строкой: 


#11пс1и0е “Тез20с01а109. п” 


4. Добавьте библиотеку импорта Ех20с в список входных библиотек ком- 
поновщика. Выберите меню Рго}есе в У15иа1 С++ .МЕТ команду АЗа Ех!зИпе Пет 
и добавьте в проект файл \Ех20с\РеБиз\Ех20с.ИЪ. Теперь программа будет не- 
явно компоноваться с Ех20а.011, и Ех20с.011. Как видите, клиенту, в общем-то, 
все равно, какая это ОШ; обычная или ОИ.-расширение. Вы лишь указываете 
компоновщику имя библиотеки ШВ. 

5. Соберите и протестируйте измененное приложение Ех20Ъ. Выберите в 
меню Те5( команду Ех20с РИ. Введите в поле ввода при! какое-нибудь число 
и щелкните кнопку Сотрще $аге. Резульгат должен появиться в поле Ошри. 


ОС: с пользовательскими 
элементами управления 


Программисты применяют РИ, для хранения пользовательских элементов управ- 
ления (сизют сопиго|з) чуть ли не с первых дней \/п9о\5, потому что такие эле- 
менты управления полностью автономны. Раньше их писали на С и конфигури- 
ровали как автономные ОШ. Сегодня к нашим услугам МЕС-библиотеки и масте- 
ра, позволяющие упростить программирование. Для пользовательских элементов 
управления лучше всего подходит обычная ОИ, поскольку им не нужен интер- 
фейс С++ и их предполагается использовать в любой среде программирования, 
воспринимающей такого рода элементы (например, в ВоПапа С++). Кроме того, 
вы, наверное, предпочтете вариант динамической компоновки с МЕС -— в этом 
случае РИ, компактнее и загружается быстрее. 


Понятие пользовательского элемента управления 


Вы уже познакомились с обычными (в главе 7) и стандартными (в главе 8) эле- 
ментами управления \УЛп4о\$, а в главе 9 — и с АсйуеХ-элементами. Пользователь- 
ский элемент управления аналогичен обычному (вроде поля ввода) в том плане, 
что тоже посылает родительскому окну уведомляющие сообщения ЯМ СОММАМО 
и получает сообщения, определяемые пользователем. Редактор диалоговых окон 
позволяет включать такие:элементы в шаблоны диалоговых окон. Для этого и 
предназначена соответствующая кнопка в окне палитры элементов управления. 
Вам предоставляется большая свобода при разработке собственного элемента 
управления. Вы можете нарисовать в его окне, управляемом клиентским прило- 
жением, все, что вздумается, и определить любое уведомление и связанные с ним 
сообщения. Соотнести обычные \/Л1п9оу’-сообщения со своим элементом управ- 
ления (например, ИМ ГВОТГОМРОММ) позволяет окно Ргорегие$ утилиты С1а$5 У1еу, 
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но обработчики уведомляющих сообщений в классе родительского окна и об- 
работчики пользовательских сообщений придется создавать вручную. 


Оконный класс пользовательского элемента управления 


Пользовательские элементы управления определяются в шаблоне диалогового 
ресурса по символьным именам их оконных классов. Не путайте оконный класс 
\1п32 с классом С++ — общее у них только название. Оконный класс определяет 
структура, содержащая: 

Ш имя класса; 


@ указатель на функцию \паРгос, которая принимает сообщения, отправленные 
в окна данного класса; 


Ш вспомогательные атрибуты (например, кисть фона). 


\Ип32-функция Кез етС/а5; копирует структуру в память процесса так, что 
любая функция в данном процессе может создать окно на основе этого класса. 
После инициализации диалогового окна \/поууз создает дочерние окна пользо- 
вательских элементов управления в соответствии с именами оконных классов, 
хранящихся в шаблоне. 

Пусть функция ИпаРгос элемента управления находится в О. При инициа- 
лизации (вызовом ОИМат) РИ, может вызвать для элемента управления функцию 
КейметС1я55. Поскольку РИ, является частью процесса, клиентская программа 
получает возможность создавать дочерние окна класса пользовательского элемента 
управления. Клиент знает имя оконного класса элемента управления и использу- 
ет его при создании дочернего окна. Весь код элемента управления, включая 
УпаРгос, хранится в ПТ... Вам нужно только, чтобы клиент загружал ОШ, до созда- 
ния дочернего окна. 


Библиотека МЕС и функция И/парРгос 


Итак, УЛп4о\$ вызывает УиаРгос элемента управления для каждого сообщения, 
отправленного в это окно. Но не пишите старомодные операторы 5$шйср/сазе — 
сопоставьте эти сообщения с функциями-членами классов С++ так, как вы уже 
делали это ранее. Для этого добавьте в РМ, класс С++, соответствующий оконно- 
му классу элемента управления; затем в окне Ргорегие$ утилиты С1а$$ У1е\ создайте 
обработчики сообщений. 

Написать класс С++ для элемента управления несложно — просто создайте с 
помощью Ааа Саз$ УЛгага новый класс, производный от Спа. Куда сложнее связать 
класс С++ с функцией УпаРгос и системой маршрутизации сообщений в каркасе 
приложений. В примере Ех204 вы увидите реальную функцию УпаРтос, а здесь 
мы приведем псевдокод типичной функции элемента управления: 


ГВЕЗИЕТ МуСоптго1МпаРгос(НИМО Пипа, ИТМТ пеззаде, МРАВАМ мРагат, ЕГРАВАМ 1Рагат) 
{ 
11 (это первое сообщение для данного окна) { 
Сита» рипа = пем СМуСопго1\1паомСТа$$(): 
свяжите рипа с П\па 
} 
гефигп АТхСа11\\МпаРгос(рипа, пМпд, теззаде, мРагат, 1Рагат) 
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МЕС-функция АХСаШУпаРгос передает сообщения каркасу приложений, а тот 
пересылает их функциям-членам СМуСоштойтаошС1а$$. 


Уведомляющие сообщения 
пользовательских элементов управления 


Элемент управления общается с родительским окном, посылая ему уведомляющие 
сообщения ИМ_СОММАЮО с такими параметрами: 


Параметр Назначение 

шРатат (старшее «слово») Код уведомления 

иРагат (младшее «слово») Идентификатор дочернего окна 
'Ратат Описатель дочернего окна 


Значение кода уведомления зависит от конкретного элемента управления. 
Родительское окно должно «уметь» интерпретировать этот код с учетом того, что 
ему известно о данном элементе управления. Например, код 77 мог бы означать, 
что пользователь ввел символ при установленном на элементе управления фоку- 
се ввода. Элемент управления может отправить уведомляющее сообщение так: 


бетРагепт ()->5епаМеззаде (\М_СОММАЮО, 
6е+019С1г110() : 10_№ТТРУСООЕ << 16, (10№6) бетЗатенмпа()); 


На клиентской стороне нужно сопоставить это сообщение функции-обработ- 
чику посредством МЕС-макроса ОМ_СОМТКОЕЁ 


О№_СОМТВОЕ (ТО_МОТТРУСООЕ, ТОС_МУСОМТВОЕ, 0пС11скедМуСоптго1) 
и объявить функцию-обработчик: 


аРх_тз9 \019 ОпС11скедмуСопго1(); 


Пользовательские сообщения, 
направляемые в элемент управления 


Вы уже сталкивались с пользовательскими сообщениями в главе 7. Они нужны 
клиентской программе для взаимодействия с элементом управления. Поскольку 
стандартное сообщение возвращает 32-разрядное значение (если сообщение от- 
правлено синхронно), в ответ клиент может получать информацию от элемента 
управления. 


Пример Ех204: пользовательский элемент управления 


Ех204 — это обычная РИ, на базе МЕС, которая реализует элемент управления 
«светофор» и переключает его состояние: «выключен», красный, желтый, зеленый. 
При щелчке светофора левой кнопкой мыши уведомляется его родительское окно, 
кроме того, он реагирует на два пользовательских сообщения: КУС_5ЕТУТАТЕ и 
КУС_СЕТУТАТЕ. Состояние определяется целым числом, кодирующим цвет. Автор 
этого элемента управления — Ричард Уилтон (Е1свага УЛИоп) — включил его ис- 
ходную версию на языке С в книгу «УЛпАо\з 3 Оеуе!орег5 \огК$Вор» (Мсгозой 
Ргезз, 1991). 
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Изначально проект Ех204 сгенерирован МЕС АррИсаНоп \У/Лтага (компоновка 
с общими ПИ, библиотеки МЕС) — как и Ех20с. Исходный текст показан ниже, 
причем добавленный в функцию ийтзяапсе код выделен. Экспортируемая функ- 
ция-заглушка Ех20ЧЕпт"у нужна лишь для того, чтобы РИ, можно было подклю- 
чить неявно. Клиентская программа должна вызывать эту функцию. Вызов дол- : | 
жен быть в пути исполнения программы, иначе компилятор проигнорирует вы- 
зов. В качестве альгернативы клиентская программа могла бы подключать РИ, и | 
явно, вызывая в туапсе УЛп32-функцию ГоаИьтаху. 


Ниже показан листинг класса СКуз\па, в том числе глобальной функции Кув- 
\УпаРтос. Для создания этого класса вызовите мастер Ада С!а$$ УЛгага: в меню Рго}есе 
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выберите Ааа С1аз5. Код изменения цвета светофора не очень интересен, поэто- 
му мы сосредоточимся на функциях, общих для большинства пользовательских 
элементов управления. Статическая функция-член Кевёе п4С1а5; регистрирует 
оконный класс КУС и должна вызываться сразу после загрузки РИ. Обработчик 
ОшШВийопроит вызывается при щелчке левой кнопкой мыши в окне элемента 
управления. Он отправляет уведомление о щелчке родительскому окну. Переопре- 
деленная функция РозИУсрезтоу очень важна — она удаляет объект СКув\7па, ког- 
да клиентская программа уничтожает окно элемента управления. Функции ОийСе!- 
$ще и Оп5е1б ще вызываются в ответ на пользовательские сообщения, синхрон- 


но отправленные клиентом. И последнее: не забудьте скопировать ПИ, в систем- 
ный каталог. 
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см. след. стр. 
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Коррекция Ех20Ь для проверки Ех204.41 


Программа Ех20Ь уже компонуется с ОИ.-модулями Ех20а и Ех20с. Теперь мы 
переработаем проект так, чтобы программу неявно связать с пользовательским 
элементом управления Ех204. 


1. Добавьте новый диалоговый ресурс и класс в проект Ех20Ъ. С помощью 
редактора диалоговых окон создайте шаблон [РО_ЕХ20р с пользовательским 
элементом управления и идентификатором дочернего окна 2С_КУСД. 

Укажите для оконного класса пользовательского элемента управления 
имя КУОС. 

Затем средствами мастера Ада С!а5$ УЛлага в окне Ргорегиез утилиты С!а$$ 
Уте\у сгенерируйте класс С7е51:2040щов, производный от СОй08. 
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Отредактируйте файл Тез{204 0110.6. Добавьте закрытую переменную-член: 
епит {0ЕР, ВЕБ, УЕСЕОМ, СВЕЕМ} т_п5тате; 


Объявите также импортируемую функцию и идентификаторы пользователь- 
ских сообщений: 


ехтегп “С” __9ес1$рес(9111трогЕ) мо1а Ех219Епегу(); // функция-заглушка 
#ает1пе ВУб_ЗЕТЭТАТЕ ММ_05ЕВ + 0 
заеР1пе ВУб_СЕТЭТАТЕ ММ_ОЗЕВ + 1 


Отредактируйте конструктор в Тез{20401а108.срр для инициализации 
переменной-члена — флажка состояния. Добавьте выделенный код: 


СТе${20901а109: :СТез120401а109(С\па* рРагеп+ И*=МЕ»/) 
(01а109(СТе${21901а109::100, рРагеп{) 
{ 
т_пофафе = ОЕ; 
Ех209Ептгу(); // Проверяем загрузку О 
} 


Создайте обработчик уведомляющего сообщения о щелчке элемента 
управления. Здесь С1а5$ У1е\ не поможет — придется вручную добавить эле- 
мент таблицы сообщений и функцию-обработчик в файл Тез204[1а1оэ.срр: 


У01а СТезт20901а109: : ОпС11скеаВуд() 
{ 
эмасп(т_пЗфате) { 
сазе ОЕЕ: 
м пфафе = АЕБ; 
огеак; 
сазе ВЕВ: 
т_пфафе = УЕШЕОИ; 
бгеак; 
сазе УЕШЕОМ: 
_пЭфафе = СВЕЕМ; 
Огеак; 
сазе СВЕЕМ: 
_пофафе = ОЕЕ 
ргеак; 


} 


бет019Т{ем( Т0С_ВУб) ->ЗепаМеззаде (ВУб_ЗЕТЗТАТЕ, т потате): 
гетигп; 


\л 
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ВЕСТА МЕЗЗАСЕ_МАР(СТез{20901а109, С01а109) 
О№_СОМТВОЕ(0, ТОС_ВУ@, 0пС11скедВуд) // код уведомления - 0 
ЕМО_МЕЗЗАСЕ_МАР() 


Получив уведомление о щелчке, диалоговое окно отправляет сообщение 
КУС_ЗЕТУТАТЕ обратно элементу управления, чтобы тот изменил свой цвет. Не 
забудьте добавить в файл Тез{204[1а1о2.В прототип: 


аРх_т$9 \019 0пС11скедвуд(); 


Включите класс С1е51204014408 в приложение Ех20Ъ. 
Добавьте в меню Те$ вторую команду — Ех204 ПИЛ, с идентификатором 
Ш_ТЕЗТ ЕХ200ПИ. В окне Ргорегиез утилиты С!а$5 У1е\у сопоставьте эту коман- 


ду функции-члену в классе СЕх2ОБ\е и напишите код обработчика в Ех20Ь- 
МУ1е\уусрр: 


\019 СЕх2ОБ\1ем: : ОпТез{Ех2049911() 
{ 

СТез+20901а109 919; 

919. ОоМода1(); 


И, конечно, включите в файл Ех206\1еуусрр строку: 


{1пс1и9е “Тез{20901а109.1” 


Добавьте библиотеку импорта Ех204 в список входных библиотек ком- 
поновщика. В меню Рго]ес{ выберите команду Ааа Ех!5Ипе Цет и добавьте в 
проект файл \усррпег\ Ех204\Рериэ\Ех20.1Ь. Теперь программа должна неяв- 
но подключать все три ОГ. 

Соберите и протестируйте измененную программу Ех20Ъ. Выберите из 
меню Тез( команду Ех20а РГ. Попробуйте пощелкать светофор левой кноп- 
кой мыши — он должен изменять свой цвет. 
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МЕС-программы без классов 
«документ» и «вид» 


Дн «документ-вид» полезна для создания многих приложений, но иногда 
можно обойтись более простой структурой программы. В этой главе приведены 
три приложения, основанные: на диалоговом окне, $01- и МП!-интерфейсах. Ни 
в одном из них нет классов «документ», «вид» или «шаблон документа», зато есть 
система маршрутизации команд и ряд других средств библиотеки МЕС. В У!иа! 
С++ .МЕТ все три типа приложений создаются средствами МЕС АррИсацоп У/гага. 

В каждом примере мы посмотрим, как МЕС АррИсаНоп УЯлага генерирует код, 
не зависящий от архитектуры «документ-вид», и покажем, как добавлять в прило- 
жение свой код. 


Пример Ех21а: приложение — диалоговое окно 


Во многих приложениях пользовательский интерфейс вполне может состоять из 
диалогового окна — оно открывается после запуска приложения. Пользователь 
может свернуть его и, поскольку оно не системное модальное, свободно переклю- 
чаться на другие программы. 

В этом примере диалоговое окно — это простой калькулятор (рис. 21-1). С1а$$ 
Меу/ определяет переменные-члены класса и создает вызовы ООхХ-функций, от- 
вечающих за обмен данными в диалоговых окнах, — словом, возьмет на себя все, 
кроме кодирования функции, нужной для вычислений. Диалоговое окно и значок 
программы определены в файле описания ресурсов Ех21а.гс. 
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50.0555555555556 


Рис. 21-1. Диалоговое окно Ех21а Сасшают 


МЕС АррНсаНоп \/12агА поддерживает создание приложений на основе диало- 
гового окна, чем мы и воспользуемся. 
р 


1. Спомощью МЕС АррИсаНоп \/12аг4 создайте проект Ех21а. На странице 
АррНсайоп Туре установите переключатель в положение П1а10о5 Вазе4. 


МЕС АррисаНоп УЙгае - ЕА2а 


'Аррйсайоп Туре 


Зресву Оосутеп Мец» агсРКесёиге зиррой,, |апдаде, апд /пкетРасе уе орНопз Гог убиг 
аррисавоп, 


ЕпоВ (Упйед экаез) 


На странице Озег ИцегЁасе Ееагагез в поле П!аюз ИИе введите заголовок 
окна — Ех21а Сайсщшатог. 

2. Отредактируйте ресурс ШО_ЕХ21А МАГОС. При этом руководствуйтесь 
рис. 21-1. Назначить элементам управления идентификаторы (см. таблицу) 
поможет редактор диалоговых окон. Затем откройте окно РгорегЧе$ диалого- 
вого окна и присвойте свойствам Зубет Мепи и Мите Вох значение ТВОЕ. 


Элемент управления Идентификатор 

Поле ввода левого операнда РС _ТЕЕТ 

Поле ввода правого операнда ШРс_ЮСНТ 

Поле ввода для резульгата )2С_ЮЕЗШТ 

Первый переключатель (с группированием) Ш)РС_ОРЕКАТОМ 

Кнопка Сотрще 1РС_СОМРИТЕ 


3. Средствами АА Метьег Уаг1аЫе \/12аг4 добавьте переменные-члены 
ивокне Ргорегиез утилиты С1а5$ У1еуу создайте обработчик команды. 


16—2064 
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МЕС АррИсаНоп УЛ2аг4 уже сгенерировал класс СЕх2 1 а ю. Дополните его пере- 
менными-членами: 


Идентификатор Переменные-члены Тип 
ШРС ТЕЕТ т_Чей РочЫе 
ШС _ЮСНТ т_ ам РоцЫе 
Ш)С_КЕЗОГТ т_АКезий РочЫе 
Ш)С_ОРЕКАТОМ т_порегайопт И 


Добавьте обработчик сообщений ОпВиСйсвейСотрише для кнопки 0С_СОМРИТЕ. 


4. Напишите функцию-член ОнВиСИсвейСотрше в файле Ех21а0]е.срр. 
Введите выделенный код: 


\0149 СЕх21а019: :ОпВпС11скедботри{е() 
{ 
Ордатерата(ТВИЕ); 
17 (т_пОрега{1оп == 0) { 
т_9Вези1* = м_д1еРе + м_98191*; 
} е1зе 1Р(т_пОрега1оп == 1) { 
т_9Вези1 = м_д1ете - м_94191*; 
} е1зе 1Р(т_пОрега1оп == 2) { 
т_9Вези1{ = м_д1егЕ + м_98191*; 
} е15е 1Р(т_пОрега1оп == 3) { 
1(т_9В198Е == 0) { 
АГхМеззадеВох( "01\14е Бу хего“); 
} е1зе { 
т_09Вези1+ = м_91еге / м_98191*; 
} 
} 
Урдатебата( РАЕЗЕ); 


} 


5. Соберите и протестируйте приложение Ех21а. Заметьте: значок програм- 
мы появляется на панели задач УЛпаоууз. Убедитесь, что диалоговое окно можно 
свернуть. 


Функция пИт$апсе класса приложения 


Важный элемент приложения Ех21а — функция СЕх2 1аАрр:/ипяапсе, созданная 
МЕС Арр|ИсаНоп \УЛтага. Обычная функция /ийтяапсе создает основное окно-рамку 
и возвращает ТКОЕ, после чего запускается цикл обработки сообщений. Но ее версия 
в Ех21а конструирует объект модального диалогового окна, вызывает РоМоаа и 
возвращает ЕА/5Е. Это означает, что приложение завершается, как только пользо- 
ватель закрывает диалоговое окно. Функция РоМоаа/ позволяет \Лп4оу%’з-проце- 
дуре диалогового окна получать и распределять сообщения как обычно. Заметь- 
те: МЕС АррИсацоп УЛтага не создает вызова СтАрр::5еЖевтуКеу. 
Взгляните на сгенерированный код ритзяатсе из Ех21а.срр: 


ВОО СЕх2ЛаАрр: :Ти1Тпзтапсе( ) 
{ 


// Ти1СоттопСоп{го1$() 1$ геди1гед оп М1паом$ ХР 11 ап арр11са+1оп 


ГЛАВА 21 МЕС-программы без классов «документ» и «вид» 455 


// тап1Рез{ зрес111ез изе оЁ СотС+132.911 \мегз1оп 6 ог 1а\фег То епаб1е 
// М1зиа1 з+у1ез. О\+Пегм1зе, апу м1пдом сгеаф1оп м111 Г№а11. 

Ти СотмопСопго13(); 

СИ1пАрр: : Тп1Тизтапсе(); 

АРХЕпаб 1 еСоптго1Сопфазпег(); 


СЕх21а019 919; 
м_рМа1п\па = &919; 
Т№МТ_РТВ пВезропз$е = 919. ВоМода1 (); 
1 (пНезропзе == Т100К) 
{ 
// 1000: Р]асе соде пеге фо Папа1е мпеп {пе 41а109 1$ 
// 9131133е49 ман ОК 
} 
е1зе 1! (пВезропзе == ТОСАМСЕС) 
{ 
// Т000: Р1асе соде пеге То папд1е мпеп Т1е. 91а109 1$ 
// 913т1$зеа мафИ Сапсе1 
} 
// 51псе {пе 91а109 паз Бееп с10зе4, гефигп РАЕЗЕ зо Тпаф ме ех1{ тпе 
// арр11сат1оп, гафпег {Пап зфаг{ пе арр11сат1оп’з меззаде ритр. 
гетигп РАЁЗЕ; 


Класс диалогового окна и значок программы 
В созданном мастером классе СЁх2 1 а 0 есть два элемента таблицы сообщений: 


О№_ИМ_РАТМТ() 
О№_ИМ_ОЦЕАУОВАСТСОМ( ) 


Соответствующие функции-обработчики отвечают за отображение значка 
программы при сворачивании ее окна. Они нужны только в УЛп4оууз МТ 3.51, в 
которой значки свернутых программ находятся на рабочем столе, и не требуют- 
ся ни в УЛпао\$ 95/98, ни в УЛиаоу% МТ 4.0/2000/ХР, поскольку в них значки свер- 
нутых программ размещаются на панели задач. 

Однако кое-какой код для значков нужен. Он находится в сгенерированном МЕС 
АррИсаНоп У/1тага обработчике ОттйРйжщов сообщения ИМ _1МГГЫАГОС. Обрати- 
те внимание на два вызова 5еЙсоп. МЕС АррНсаноп У/тага формирует код для 
добавления в системное меню команды АБоц! (если вы установили флажок АБош 
Бох). т_Всоп — переменная-член класса диалогового окна, инициализируемая в 
конструкторе 


ВО0Е СЕх21а019: :ОпТп1101а109() 

{ 
(С01а109: :Оп1п1101а109(); 
// АЧЧ “АБоит..." тепи 1%ет фо зузтет мепи. 
//.ТОМ_АВОУТВОХ тизф Бе 1п пе зузфет соттапа гапде. 
АЗЗЕАТ ( (ТОМ_АВОЦТВОХ & ОхЕЕРО) == ТОМ_АВОЦТВОХ); 
АЗЗЕВТ (ТОМ_АВОУТВОХ < 0хР000); 
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СМепи» рзузМепи = бетбузтетМепи( РАЕЗЕ); 
11 (рЗузМепи != М.) 
{ 
С$1г1п9 эЕгАБоиМепи; 
ЗЕгАБоц{Мепи. [оад31г1п9(10$_АВОУТВОХ): 
17 (!3{гАБоцМепи. ТзЕтрфу()) 
{ 
роузМепи->АррепдМепи (МЕ_ЗЕРАВАТОВ); 
роузМепи->АррепаМепи(МЕ_5ТВТМС, 
ТОМ_АВОПТВОХ, зЕгАБои{Мепи); 


} 

// Зе{ 1пе 1соп Рог 111$ 91а109. Тпе Ргатемогк 40ез {113 

// аитота{1са11у мпеп 11е арр11са{1оп’з та1п мапдом 

// 13 по{ а 91а109. 

Зе{Тсоп(т_ИТсоп, ТВИЕ); // Зе{ 19 1соп 

бетТсоп(м_ПТсоп, ЕАЕЗЕ); // Зе{ зта11 1соп 

// Т000: АЯ ехега 1п1{1а112аф1оп пеге 

гефигп ТВУЕ; // гефигп ТВОЕ ип1езз уои зеф 11е Росиз Жо а соп{го1 


Пример Ех21Ь: $0|!-программа 


Эта 5Б1-программа из серии «НеНо, уоа!ь построена на основе кода из главы 2. 
У нее одно окно — объект класса, наследующего классу СЕгате\та. Операции 
прорисовки выполняются в окне-рамке, там же обрабатываются и все сообщения. 


1. Средствами МЕС АррИсаЧоп У/]12таг4 Ех21Ъ. На странице АррИсаНоп Туре 


установите переключатель в положение 51п21е 4оситепи и сбросьте флажок 
Роситеп/\М1е\ АгсВиестаге биррог: 


| АррйсаЧоп Туре 
Эредбу РоситепЕ\Ием агсРиесвиге зиррок, (апдиаде, ап икегЁасе $К\е орНопз Гог уси" 
аррйсаноп, 


2. Добавьте код прорисовки диалогового окна. В функцию ССЬИЧИеи::ОпРайи! 
в файле СВИа\ехусрр добавьте выделенный код: 


\01а ССп11а\1ем: :ОпРазп*() 
{ 
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3. 


СРа1п0С 9с({11$); // де\у1се сопфехе Рог ра1п1пд 
дс. ТехЕ0и{(0, 0, "Не11о, мог1а!“); 


// 00 поф са11 СМпа: :ОпРа1ит() Рог ра1п1п9 тмеззадез 
} 


Скомпилируйте и запустите приложение. Мы получили полноценное $0]- 
приложение, которое никак не зависит от архитектуры «документ-вид». 


МЕС АррНсайоп У/гаг4 автоматически удаляет из приложения все следы этой 


зависимости и создает следующие элементы. 


Основное меню. Х/п4о\5-приложение может обойтись без меню и даже без 
описания ресурсов. Но в примере Ех21Ь есть и то и другое. Каркас приложе- 
ний маршрутизирует команды меню обработчикам сообщений в классе окна- 
рамки. 

Значок. Полезен, если программу предполагается запускать из УЛпао\з$ Ехрюгег 
или сворачивать ее основное окно-рамку. Значок, как и меню, хранится в ре- 
сурсе. 

Обработчик командного сообщения о закрытии окна. Многие програм- 
мы должны проделывать ряд особых операций в момент закрытия основного 
окна. Если бы вы использовали документы, то могли бы переопределить функ- 
цию СРоситеп!::$ агеМо@йеа. Но здесь, чтобы контролировать процесс закрытия, 
надо написать обработчики сообщений о закрытии окна, посылаемых програм- 
ме в ответ на действия пользователя или самой УЛпдо\з при завершении ее 
работы. 

Панель инструментов и строка состояния. МЕС Арр|сайоп У/гага авто- 
матически генерирует панель инструментов и строку состояния и настраива- 
ет маршрутизацию сообщений, хотя классов «документ» и «вид» здесь нет. 


У $0[-приложений без поддержки архитектуры «документ-вид» есть несколь- 
ко интересных характерных особенностей. 


Класс ССЬИ4\еи; вопреки своему названию на самом деле наследует Спа и 
объявляется в СоЦа\1еу”.В и реализуется в СВИА\У1еуусрр. Этот класс реализует 
только виртуальную функцию-член ОпРайи, которая содержит весь код для 
рисования в окне-рамке всего, что нужно (см. шаг 2 в примере Ех21Ь.) 

Класс СМатЕгате содержит переменную-член т_шпаЙе, которая создает- 
ся и инициализируется в функции СМатЕгате::ОпСтеве. 

Функция СМатЕгате::Оп$е Еосиз$ передает фокус окну ССЬИЯИЙеи»: 


\019 СМа1пЕгате: :ОпЗе{Росиз (Супд»* р019\па) 
{ 
// передаем фокус дочернему окну 
т_мпд\зтем. зе*Росиз(); 


} 


Функция СМатЕгате::ОпСт@ М5 дает шанс дочернему окну первым обра- 
ботать любые командные сообщения: 
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ВООГ СМа1пЕгаме: :ОпСтаМ$9(ИТМТ пТО, 1пе пСоде, уо19* рЕхуга, 
АРХ_СМОНАМОСЕВТМЕО* рНапд1егТпто) 
{ 
// даем дочернему окну возможность обработать команду первым 
11 (т ипа\У1ем. ОпСтам$9(пТО, пСоде, рЕхфга, рНапа1егТито)) 
гефигп ТВИЕ; 


// в противном случае выполняем обработку по умолчанию 
гетигп СЕгатемпа: :ОпСтаМ$9(пТ0, пбоде, рЕхфга, рНапа1егТп\о); 


Пример Ех21с: МО|-приложение 

Создадим МПГ-программу без поддержки архитектуры «документ-вид». 

1. Средствами МЕС АррИсаНоп У/1таг4 создайте проект Ех21с. На странице 
АррИсацоп Туре установите переключатель в положение Мире Чосштеп( и 
сбросьге флажок Роситепи/\1е\у Агспиестге биррог". 


2. Добавьте код прорисовки дочернего окна. В функцию ССрЙйаЩеи»::ОпРат! 
в файле СоИАа\У1еусрр добавьте выделенный код: 


У019 ССи11а\1ем: : ОпРа1п*() 
{ 
(Ра1п0С 9с({11$); // Чдем1се соптехе Рог рафп1тп9 


дс.Техе0и*(0, 0, “Не11о, мог1а!"); 


// 00 поф са11 Смпа: :ОпРа1п{() Рог ра1п{1пд меззадез 
} 


3. Скомпилируйте и запустите приложение. Мы получили полноценное МП]- 
приложение, которое никак не зависит от архитектуры «документ-вид». 


Как ив Ех21Ъ, здесь автоматически создается класс СОрйа\еи,. Основное раз- 
личие между Ех21Б и Ех21с втом, что класс ССЬиЯ\Щеил создается в функции ССЬЙа- 
Етате::ОпСгеаЕ, а не в классе СМатЕгате. 

Итак, вы научились создавать приложения трех типов, не зависящие от архи- 
тектуры «документ-вид». Создание этих приложений — прекрасный способ понять 
работу МЕС. Мы советуем вам сравнить приложения с поддержкой и без поддер- 
жки этой архитектуры, чтобы получить исчерпывающее представление о том, как 
классы «документ» и «вид» работают с остальной частью МЕС. 


' Точнее, объект этого класса. — Прим. перев. 


ЧАСТЬ 4 


СОМ, АЧТОМАПОМ, 
АСПУЕХ И ОЁЕ 


ГЛАВА 


22 


Модель компонентных 
объектов 


М. одель компонентных объектов (Сотропеп ОБеси Моде! СОМ) лежит в осно- 
ве технологии М!сгозой Аспуех. Она стала неотъемлемой частью М1сгозой УЛп9о\%5, 
и поэтому рассказ о ней — обязательная часть этой книги. С чего же начать? Мо- 
жет, с МЕС-классов для элементов управления АсНйуеХ, АмотаНоп и ОГЕ? Но эти 
классы, как бы полезны они ни были, скрывают истинную архитектуру СОМ. Значит, 
начинать надо с фундаментальной теории, а она включает в себя собственно СОМ 
и интерфейсы. 

В этой главе вы получите теоретические сведения, необходимые для усвоения 
материала следующих шести глав. Вы узнаете об интерфейсах и о том, как библио- 
тека МЕС реализует их через свои макросы и карты интерфейсов (име!асе тар). 


Основы технологии АсНуех 


Терминология меняется столь же стремительно, как и технология, и даже внутри 
Мисгозой нет единства относительно того, как использовать термины АсйуеХ и 
ОТЕ. Считайте, что АсиуеХ — это нечто, возникшее при столкновении «старого» 
ОТЕ и Интернета. АспуеХ включает в себя не только те возможности \/1190%5, ос- 
нованные на СОМ, которые мы рассмотрим именно в этой части, но и семейство 
М1сгозой Ицегпе! шЮюгтаНолп 5егуег и программный интерфейс УЛитее. 

Да, ОТЕ по-прежнему жива и теперь вновь расшифровывается как ОБ}есе Мите 
апа ЕтБеаАто (связывание и внедрение объектов); как и в дни ОГЕ 1.0. Сейчас 
это просто еще одно подмножество технологии АсйуеХ, содержащее всякую вся- 
чину, например операцию @газ-ап4-агор (перетащить и отпустить). К сожалению 
(или к счастью, если у вас есть ранее написанный код), исходный МЕС-код и 
УЛпао\5 АРГ не следуют за последними изменениями терминологии. Поэтому в 
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названиях функций и классов вы увидите множество упоминаний ОЕ и ОГ, хотя 
некоторые из этих функций выходят за рамки связывания и внедрения. В этой 
части книги в коде, сгенерированном МЕС АррИсаНоп УЛгага, вы можете заметить 
упоминания о «сервере» (5егуег). Теперь Мсгозой резервирует этот термин толь- 
ко для серверов баз данных и Интернет-серверов. В отношении ОГЕ-серверов 
применяется новый термин — компонент (сотропепо. 

Компьютерные секции книжных магазинов забиты книгами по ОГЕ, СОМ и 
АсНуех. Мы не обещаем достигнуть той глубины, которой отличаются эти труды, 
но вы наверняка получите хорошее представление о теории СОМ. Мы уделим боль- 
шее, чем в других книгах [кроме «МЕС Иегпа!5» (АЧЧ1оп-\е$1еу, 1996) Джорджа 
Шеферда и Скотта Уингоу (Сеогве Зпервега и $со1 \//п20)], внимание связи СОМ 
с классами библиотеки МЕС. Это послужит хорошей подготовкой к штудирова- 
нию серьезных трудов по АсцуеХ/СОМ, в том числе «шпяе ОГЕ» (М!сгозой Ргез5, 
1995) Крейга Брокшмидта (Кга!е, Вгоскзсвиа®) и «ЕззепНа! СОМ» (Ааа1зоп-\е$еу, 
1998) Дона Бокса (Роп Вох). Хорошая книга средней трудности — «пе СОМ» 
(Мисгозой Ргезз, 1997) Дейла Роджерсона (Рае Корегзоп). 

СОМ приносит столько же проблем, сколько решает. Большую часть этой тех- 
нологии заменит компонентная модель МЕТ со своими сборками (аззет у) и СЕБ- 
средой (сотглоп 1апзиазе гапите). Тем не менее СОМ пока в силе. Итак, в путь. 


Что такое СОМ 


СОМ — это программная архитектура динамического компоновки ПО. В СОМ 
предпринята попытка решить проблемы поддержки версий (этим «грешат» ры) 
и сложности механизма удаленного вызова процедур (гето{е ргосеаиге сай, КРО). 

Проблема в том, что в УЛп4о\ нет стандартного способа взаимодействия между 
программными модулями. «Но, — скажете вы, — а как же РЦ, с их экспортируе- 
мыми функциями, ОБЕ, буфер обмена и все АРГ-интерфейсы \Лп4оу%з, не говоря 
уж об устаревших стандартах вроде УВХ и ОТЕ 1? Разве этого мало?» Увы, да. Вы 
не построите объектно-ориентированную операционную систему будущего из 
этого «зверинца» разрозненных, узкоспециализированных стандартов. 


Сущность СОМ 


У старых стандартов много недостатков. У УЛпЧо\у5 АР! слишком велика «площадь 
покрытия» — свыше 350 функций; УВХ-расширения не «живут» в 32-разрядном 
мире; в ОБЕ чрезмерно запутанная система приложений (аррИйсацоп), тем (гор!) 
и элементов (пет); обращение к РИ, всецело зависит от конкретного приложе- 
ния. Модель СОМ предоставляет унифицированный, открытый, объектно-ориен- 
тированный протокол связи между программами, который поддерживает: 

Ш стандартный, не зависящий от языка программирования способ загрузки и 

вызова УЛп32-модулей РИ, клиентскими \/1п32-программами; 


Ш универсальный способ управления одной ЕХЕ-программы другой, выполняе- 
мой на том же компьютере (замена РОЕ); 


Ш элементы управления АсНуех, пришедшие на смену УВХ-элементам; 
Ш новый мощный способ взаимодействия прикладных программ с ОС; 
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Ш расширения для поддержки новых протоколов вроде интерфейса баз данных 
ОТЕ БВ; 

Ш П15НЬшеа СОМ (РСОМ) — технологию, позволяющую взаимодействовать про- 
граммам на разных компьютерах, даже если процессоры этих компьютеров 
принадлежат к разным семействам. 


Итак, что же такое СОМ? Задать вопрос намного проще, чем ответить на него. 
Главная линия, проводимая в РеуеюрМепиог (система учебных центров разработ- 
Чиков), — ЭТО «СОМ есть любовь». Иначе говоря, СОМ — это мощная интеграци- 
онная технология, позволяющая собрать разрозненные части ПО вместе в пери- 
од выполнения. СОМ дает разработчику возможность писать интегрируемое ПО, 
не вдаваясь в тонкости многопоточности и не привязываясь к конкретному язы- 
ку программирования. 

СОМ — это протокол, который соединяет программные модули, а затем поки- 
дает сцену — далее модули взаимодействуют через механизм, называемый интер- 
фейсом (ицегЁасе). Интерфейсы не требуют статического или динамического свя- 
зывания точек входа или «зашитых» в программу адресов, кроме нескольких уни- 
версальных СОМ-функций, активизирующих процесс установления связи. Ин- 
терфейс (точнее, СОМ-интерфейс) — это термин, с которым вы встретитесь еще 
не раз. 


СОМ-интерфейс 


Перед погружением в изучение интерфейсов давайте вспомним принципы насле- 
дования и полиморфизма в обычном С++. Для этого воспользуемся моделью меж- 
планетных перелетов. Представьте себе космический корабль, летящий в Солнеч- 
ной системе в гравитационном поле Солнца. При обычном программировании 
на С++ вы морли бы объявить класс Сбрасез р и написать конструктор, задающий 
начальные координаты и ускорение корабля. Затем. вы написали бы невиртуаль- 
ную функцию-член Е/у, которая вычисляла бы на основе законов Кеплера новые 
координаты корабля через определенный интервал времени, скажем, 0,1 секун- 
ды. Можно было бы написать еще и функцию Рёр/ау, чтобы изображать в окне 
космический корабль. Самая интересная особенность класса С5расезрр — это то, 
что интерфейс класса С++ (т.е. протокол взаимодействия класса с клиентом) и 
его реализация связаны между собой очень тесно. Одна из основных целей СОМ 
как раз и состоит в отделении интерфейса класса от его реализации. 

Если использовать в этом примере СОМ, код, моделирующий космический 
корабль, разместится в отдельном ЕХЕ- или РИ-файле (компоненте), который 
является СОМ-модулем. Программа-клиени не сможет вызывать Ву или конструктор 
Сбрасез@р напрямую, так как объект, описывающий космический корабль, досту- 
пен только через стандартную глобальную функцию, предоставляемую СОМ, в 
дальнейшем клиент и объект общаются через интерфейсы. 

Прежде чем взяться за настоящую СОМ, попробуем создать ее «модель», в ко- 
торой и компонент, и клиент статически скомпонованы в единый ЕХЕ-файл. Вместо 
упомянутой стандартной глобальной функции мы придумаем функцию Сес1а55- 
ОБес. В нашей модели клиенты будут пользоваться этой глобальной абстрактной 
функцией (СеС!а55ОБес!) для объектов конкретного класса. В реальной жизни 
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СОМ-клиенты вначале получают объект класса, а затем запрашивают у него со- 
здание реального объекта — во многом так же, как МЕС выполняет динамическое 
создание. У деа55Овес! три параметра: 


8001 бетСтаззО06)ест(1и{ пС1$19, 1пЕ пТ19, \№014** рру06]); 


Первый параметр — иС/54 — это 32-разрядное целое число, которое однозначно 
идентифицирует класс Сбрасезрр. Второй параметр, па, — уникальный иденти- 
фикатор нужного нам интерфейса. Третий — указатель на интерфейс объекта. 
Вспомните, что мы собираемся теперь иметь дело с интерфейсами, а это не то 
же самое, что классы. Как выясняется, класс может иметь несколько интерфейсов, 
поэтому два последних параметра и обеспечивают выбор интерфейса. При бла- 
гополучном завершении функция возвращает ТКОЕ. 

Теперь вернемся к разработке Сбрасез р. Мы еще не говорили об интерфей- 
сах космического корабля. СОМ-интерфейс — это базовый класс С++ (точнее, 
структура — $тиср), который объявляет группу чисто виртуальных функций. Эти 
функции полностью управляют той или иной стороной поведения производно- 
го класса. Для Сбрасезр мы напишем интерфейс /Мойоп, который будет управ- 
лять позицией объекта — космического корабля. Простоты ради объявим только 
две функции: Р// и СеРозйюп, и пусть позиция определяется единственным це- 
лым числом. Е/у перемещает космический корабль, а СеРозйютп возвращает его 
текущее положение. 


Зфгисе ТМо{1оп 
{ 

У1гЕиа1 у019 Е1у() = 0; 

У1гфиа1 1п1& @бетРо$1410п() = 0; 
Не 


с1азз СЗрасезй1р : риб11с ТМо1оп 
{ 
рготестед: 
11 м_пРо$1110п 
ру611с: 
СЗрасезп1р() { м_пРо$11оп = 0; } 
№\019 Е1у() 
111% бе{Ро$1{10п() { гефигп м_пРо$1410п; } 
р 
ТМоттоп» рМот; 
бетС1азз06 ест (С15Т0_СЗрасези1р, ТТО_ТМоф10п, (\014**) &рМот); 


Допустим пока, что СОМ с помощью уникальных идентификаторов С1512_С5ра- 
сезбр и По_/Мойоп создает космический корабль, а не иной объект. В случае успеха 
вызова рМо{ указывает на объект Сбрасезр, каким-то образом сконструирован- 
ный функцией Се 1яа$5ОБес. Класс Сбрасез р реализует функции Ей) и СеРо5йоп, 
поэтому основная программа может вызывать их для конкретного объекта — кос- 
мического корабля: 


11 пРо$ = 50; 
рМо{->бе{Ро$1{10п() = пРоз; 
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рМот->Е1у(); 
пРо$ = рМо{->бетРоз1+1оп(): 
ТВАСЕ( “пем роз11оп = %9\п", пРо$); // новая позиция 


Итак, корабль стартовал и ушел в полет, мы же получили полный контроль над 
ним через указатель рМо1. Заметьте: рМо! формально не является указателем на 
объект Сбрасез р, но в данном случае указатели на Сбрасезр и на [Моноп оди- 
наковы, так как Сзрасез р наследует [Моноп. Здесь хорошо видно, как работают 
виртуальные функции — классический полиморфизм С++. 

Усложним задачу, добавив второй интерфейс, Г/биа/, отвечающий за визуаль- 
ное представление космического корабля. Для него достаточно одной функции 
рёр/ау. Готовый базовый класс выглядит так: 


ЗФгист Т\1$иа1 


{ 
У1г{иа1 \%019 013зр1ау() = 0; 
# 


Вы заметили, что в СОМ нужно объединять функции в группы? Но зачем? 
В нашей модели космического пространства нам, вероятно, захочется добавить 
другие типы объектов — не только космические корабли. Представьте, что интер- 
фейсы /Мойоп и Ибиа используются другими классами. Возможно, класс Солн- 
ца, Сбип, реализует интерфейс /Убиа| но не [Моной, а класс космической стан- 
ции, Сбрасейаноп, предоставляет, кроме этих двух, еще и дополнительные интер- 
фейсы. Если вы «опубликуете» свои интерфейсы /Мойоп и ГУбиа, то не исключе- 
но, что их возьмут на вооружение другие компании, занимающиеся моделирова- 
нием космического пространства. 

Рассматривайте интерфейс как своего рода соглашение, контракт, заключае- 
мый между двумя программными модулями. Идея в том, что объявления интер- 
фейса никогда не меняются. Если понадобится обновить код, моделирующий кос- 
мический корабль, интерфейсы /Моноп и Г/биа останутся неизменны — вы про- 
сто добавите новый интерфейс, скажем, /Сгеи› — интерфейс команды корабля. При 
этом существующие клиентские программы продолжат работать со старыми ин- 
терфейсами, а новые смогут использовать /Суеш. Такие клиенты способны опре- 
делить в период выполнения, какие интерфейсы поддерживает данная версия ПО, 
моделирующего космический корабль. 

Функцию СеС1я$$ОБуес! можно рассматривать как более мощную альтернати- 
ву конструкторам классов и оператору пеш в С++. Последние позволяют создавать 
один объект с единственным набором функций-членов, а СеС4а5$ОБлес! — объект 
и возможность «говорить» с ним (интерфейс). Чуть позже вы увидите, что работа 
всегда начинается с одного интерфейса, через который узнают о других интер- 
фейсах объекта. 

Так как же запрограммировать два интерфейса для Сбрасезрр? Можно было 
бы использовать характерное для С++ множественное наследование, но оно бес- 
полезно, если два интерфейса содержат функции с одним именем. Вместо этого 
в библиотеке МЕС применяются вложенные классы (пезбе4 с1аз5ез). Не все програм- 
мис" на С++ хорошо знакомы с этим приемом, поэтому дадим кое-какие пояс- 
нени‘ ›от первый фрагмент кода для класса Срасез р, в котором используются 
вложенные интерфейсы: 
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с1азз СЗрасезй1р 
{ 
рготестед: 
11 т_пРо$1110п 
11 п_пАссе1ега*1оп; 
11 м_пСо1 ог 
руб11с: 
СЗрасезй1р() 
{ т _пРо$110п = м_пАссе1егат1опт = т_пбо1ог = 0; } 
с1азз ХМоф1оп : риб11с ТМо{1оп 
{ 
руб11с: 
ХМот10п() { } 
У1гфиа1 \у0149 Е1у(); 
У1гфиа1 1п&& бетРо$111оп() 
} м_ хМот10п 


с1азз Х\1$иа1 ; риб11с Т\/1зиа1 
{ 
руб11с: 
Х\15иа1() { } 
У1гфиа1 \019 01$р1ау(); 
} п_х\/1$иа1 


Тг1епд с1аз$ Х\15иа1; 
Тг1епд с1азз ХМо{1оп; 
}; 
АЕ ЕЕ 
Примечание Возможно, имеет смысл сделать и пАссёетайоп переменной-чле- 
ном класса ХМойоп, а т_пСоют— класса ХУбиа!. Мы же объявили их в 


классе Сбрасезр, поскольку такая стратегия лучше совместима с МЕС- 
макросами, в чем вы позже и убедитесь. 


Заметьге: реализации /Мойоп и Ибиа содержатся в родительском классе С5расе- 
5рр. В СОМ такой родительский класс известен как класс с идентификационны- 
ми данными, или «лицом» объекта (обес! 1Чер у). Заметьте также, что 7_хМойопй 
и т хУбиа! — внедренные переменныс-члены этого класса. Можно было бы реа- 
лизовать Сбрасез р исключительно за счет внедрения. Но вложение классов дает 
два преимущества: во-первых, функции-члены вложенного класса получают до- 
ступ к переменным-членам родительского класса без дополнительных указателей 
на Сбрасез р, и во-вторых, вложенные классы упакованы в родительском и неви- 
димы за его пределами. Взгляните на код функции-члена Се//» - 


11&& СЗрасезйар: :ХМот1оп: :@е{Ро$1110п() 

{ 
МЕТНОО_РВОГОСИЕ (СЗрасезпар, Мо{1оп) // создает рТП1$ 
гефигп рТ1$->т_пРо$1110п 
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Обратите внимание на оператор разрешения области видимости: он употреб- 
лен дважды, что необходимо для функций-членов вложенных классов. МЕТНОПШ_РКО- 
ТОСИЕ — это МЕС-макрос, который с помощью стандартного оператора языка С 
ое] генерирует р1№15 — указатель #15 для родительского класса. Компилятору 
всегда известно смещение от начала данных родительского класса до начала данных 
вложенного класса. Таким образом, функция СеРозйюп получает доступ к пере- 
меной-члену 7_пРоз#оп класса Сбрасез р. 

Теперь предположим, что у нас есть два указателя РМоЁи ру для какого-то 
объекта Сбрасез р. (Отложим пока вопрос о том, как их получить.) Функции-члены 
интерфейсов можно вызывать так: 


рМот->Е1у(); 
р\1$->01$р1ау(); 


Что же здесь происходит «под капотом»? В С++ у каждого класса (по крайней 
мере в абстрактном базовом классе, у которого имеются виртуальные функции) 
есть таблица виртуальных функций (умаЫе).: В нашем примере это означает, что 
такие таблицы есть у классов Сзрасезыр::ХУби и Сбрасезрр::ХМоноп. Для каж- 
дого объекта существует указатель на его данные, первый элемент которых — 
указатель на таблицу виртуальных функций класса. Структура указателей такова: 

Объект СЗрасез р 


Таблица МаЫе класса 
С5расезтр::ХМоНоп 


рМо! 


_ Закрытые переменные. 
для Буи беРозоп 


Таблица МаЫе класса 


С5расез!!р::ХИзиа! 
РИ$ —___ | ‚ функ 


Примечание Теоретически СОМ-программы можно писать и на С. Взглянув на 
заголовочные файлы У/1п40%уз, вы увидите код, аналогичный этому: 


НГдег __ср1и$р1из 
// объявления для С++ 
#е15е 

/= объявления для С */ 


#епа1Р 

В С++ интерфейсы объявляются как $исЕ, часто с наследованием, а 
в С — как руреде/ ятис1 без наследования. В первом случае таблицы вир- 
туальных функций ваших производных классов компилятор генериру- 
ет автоматически, тогда как при работе на С таблицы надо заполнять 
вручную, что весьма утомительно. Однако важно понимать, что ни в одном 
из языков в объявлениях интерфейсов нет ни переменных-членов, ни 
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конструкторов, ни деструкторов. Поэтому не полагайтесь на то, что уин- 
терфейса есть виртуальный деструктор. (Впрочем, это не проблема — ведь 
деструктор для интерфейса никогда не вызывается.) 


Интерфейс /ШпКпоит и функция-член Оиегу/тетасе 


Вернемся к тому, как получить указатель на интерфейс. Для этого в СОМ опреде- 
лен специальный интерфейс /Оикпоши. Фактически все интерфейсы производны 
от /Оикпоши, который содержит чисто виртуальную функцию-член Оиегуйиет асе, 
возвращающую указатель на интерфейс по переданному ей идентификатору ин- 
терфейса. Это предполагает, что у клиента есть указатель на какой-то интерфейс: 
либо на Опкпоит, либо на производный от него. Вот новая иерархия интерфей- 
сов, на вершине которой находится ЮОиЕпоши: 


ЗЕгисЕ ШпкКпомп 
У1гЕиа1 ВООЕ ОцегуТпфегРасе( 11 п11а, м019** рру067) = 0; 
на ТМо{1оп : риб11с ТШпкпомп 
У1гфиа1 019 Е1у() = 0; 
У1гЕиа1 1п1& бетРоз1{10п() = 0; 
ть 1\М15иа1 : риб]11с Шпкпомп 
У1гфиа1 у019 015р1ау() = 0; 
Г 


Чтобы выполнить требования компилятора, мы должны добавить реализацию 
Оиет/тетрасе как в Сбрасезр1р::ХМойоп, так и в Сбрасез1р::ХУзии. Как же теперь 
выглядят таблицы виртуальных функций? Для каждого производного класса ком- 
пилятор создал таблицу, в начале которой расположены указатели на функции 
базового класса: 


Таблица МаЫе класса Таблица МаЫе класса 
СЗрасезтр::ХМойоп С5расезт!р::ХИиа! 


Указатель на функцию биегуииеласе 
Указатель на фукциюлу | 
Указатель на функцию беРовйют — 


| Указатель на функцию иегуетасе. 


Теперь функция Се 1я5$ОБес! может получить указатель на интерфейс данного 
объекта С5расез р, получая адрес соответствующего внедренного объекта. Взглянем 
на функцию Оиег/щегасе в классе ХМонои: 


ВОО СЗрасезй1р: : ХМо1оп: :ОиегуТпфегРасе( 1 п114а, \у014** рр\0Ь1) 
{ 

МЕТНОО_РВОЕОСИЕ (СЗрасезв1р, Мо{1оп) 

ЗмТЕСЙ (1114) { 
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И мой арын бе единый У дофаыаьл о ИИС 


сазе ТТО_Т\пкпомп: 

сазе ТТ0_ТМо{1оп: 
*рру0б] = &рТп1$->т_хМо10п; 
Огеак; 

сазе ТТО_Т\15$иа1: 
*рру06] = &рТп13->т_х\/15иа1 
ргеак; 

дегаи1т: 
*рр\у06) = МЕ 
гетигп РАЕУЕ; 


} 
гетигп ТВОЕ; 


Поскольку /[Мойоп наследует 1ОиЁпоши, указатель на [Мойоп подойдет, даже когда 
вызывающая программа запросит указатель на Диёпоиши. 
ооо жи 
Примечание Стандарт СОМ требует: если в качестве параметра в Оцехупие асе 

передан ИР_/Опкпошт, функция должна возвращать один и тот же ука- 
затель на /ЮиЁпоит независимо от того, для какого указателя на интер- 
фейс она вызвана. Поэтому, сравнив два указателя на /Гиёпоши, можно 
определить, ссылаются ли они на один и тот же объект. ГЛиёпоит иног- 
да называют «уо!А*» для СОМ, потому что он представляет «лицо» (14еп у) 


объектов. 
бе ны ван ПИ ОиСТ ЕАИ СИА 2112 


Обратимся к функции Се а55ОБесг, которая на основе адреса т_хМоноп по- 
лучает первый указатель на интерфейс только что созданного объекта СЗрасез р: 


ВОО бе{С1азз06]ест(1п& пС1$14, 1пЕ& п119, \014»* рру0б]) 
{ 

АЗЗЕВТ(пС1$14 == СЕ$ЗТО_СЗрасезв1р); 

СЗрасезй1р» р06] = пем СЗрасезв1р(); 

ТОпкпомп» рУпк = &р06)->т_хМо1оп: 

гефигп рУпк->@иегуТпфегРасе(тТ1а, рру0ь]); 


Теперь клиентская программа может использовать Оиегу/шет/асе, чтобы полу- 
чить указатель на //биай 


ТМот10п» рМот; 

1\М15иа1* р\1$; 

бетС1а$з06)ест(С15Т0_Сбрасези1р, ТТО_ТМоф1оп, (\014**) &рМот): 
рМоф->Е1у(); 

рМо{->ОцегуТптегтасе( ТТО_Т\13иа1, (\%014**) &р\1$); 
р\1$->01$р1ау(); 


Заметьте: клиент, хоть и использует объект класса Сбрасез1р, никогда не по- 
лучает указатель на сам Сбрасез р. Таким образом, у клиента нет прямого досту- 
па к переменным-членам Сбрасез р, даже если бы они были открытыми. Обра- 
тите также внимание, что мы еще не пытались удалять объект СЗрасезр — все 
это еще впереди. 
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В СОМ принято особое графическое представление интерфейсов и СОМ-клас- 
сов. Интерфейсы изображаются маленькими кружками, или гнездами (дасК), ли- 
нии от которых ведут к соответствующему классу. Интерфейс ПШийпошт, поддер- 
живаемый всеми СОМ-классами, изображается сверху, а остальные интерфейсы — 
слева от класса. Класс Сбрасезрр можно представить так: 


Шпкпоипт О) 


Миа! О СЗрасезмр = 


ИМовюпт О 


Учет ссылок: функции АЧАЯе! и Ве[еазе 
В СОМ-интерфейсах нет виртуальных деструкторов, поэтому глупо писать: 


де1ете рмМот; // рМоф - указатель на ТМот1оп; 
// никогда так не делайте 


В СОМ существует строгая процедура удаления объектов, ключевая роль в ко- 
тором отводится двум функциям /Сиепошт: АаЯКе[и Кееа5е. У каждого СОМ-класса 
есть переменная-член (в библиотеке МЕС она называется т_аиЖе)), в которой 
ведется учет текущего числа «пользователей» данного объекта. Всякий раз, когда 
компонент возвращает указатель на новый интерфейс (скажем, при вызове Оие’)- 
Гиегасе), он вызывает АЯЯКе,, и та увеличивает счетчик т_@ишКе] на единицу. За- 
кончив работу с указателем на интерфейс, программа-клиент, вызывает Ке/еае, и 
та уменьшает т_4иКе] на единицу. Когда счетчик т_ашКе] обнуляется, объект 
самоуничтожается'. Вот пример функции Кееа$е из класса С5расезрр::ХМойоип: 


ОМ0ВО СЗрасези1р: :ХМот1оп: :Ве]1еазе() 
{ 
МЕТНОО_РВОЕОСИЕ(СЗрасезй1р, Мо{1оп) // создает рТп1$ 
1 (рТН13->т_амВеЁ == 0) 
гефигп 0; 
ТЕ (-рТй1$->п_9мАее == 0) { 
де1ете рТп1$; // объект “космический корабль” 
гефигп 0; 
} 
гефигп рТп1$->т_дмВет; 


В СОМ-программах на базе МЕС конструктор объекта устанавливает 7т_аиКе/ 
в 1, а это значит, что вызывать АЯЯКе] сразу после создания объекта не нужно. 
Тем не менее клиент должен вызвать АЯЯКе/ при создании копии указателя на 
интерфейс. 


' Стандарт СОМ не запрещает поддерживать счетчик ссылок на каждый интерфейс в 
отдельности, а не на весь объект в целом. — Прим. перев. 


470 Часть 1У СОМ, Ащотаноп, АсНуеХ и ОЕ 


Фабрики класса 


Терминология объектно-ориентированного программирования иногда весьма 
туманна. Например, программисты на $ташаК говорят об объектах там, где про- 
граммисты на С++ говорят о классах. В литературе по СОМ по отношению к объекту 
и ассоциированному с ним коду часто применяется термин компонентный обб- 
ект (сотропепе оБ}есо, а наряду с ним — класс объекта (с1а5з оБес® или фаб- 
рика класса (с1а$5 Гастогу). Большей точности ради его следовало бы называть 
фабрикой объектов (оБеси Еастогу)'. Объект класса в СОМ — это глобальная ста- 
тическая область данного конкретного СОМ-класса. В МЕС его аналогом можно 
считать СКипйтеС1а55. Объект класса часто называют фабрикой класса, так как 
он часто поддерживает особый СОМ-интерфейс — 1С/а5$Еасюту". Как и другие 
интерфейсы, этот тоже наследует /ОтЁпошт. Главной функцией-членом в /С/а55- 
Еасюгу является Стежщетяаисе, которую в нашей модели можно объявить так: 


У1гЕиа1 ВООЕ СгеатеТпзфапсе(111& п119, №014** рр\у0Б1) = 0; 


Для чего нужна фабрика классов? Как вы уже видели, мы не в состоянии на- 
прямую вызывать конструктор класса, но должны предоставить компоненту са- 
мому выбрать способ создания объектов. Для этого компонент предоставляет 
фабрику класса, инкапсулируя тем самым этап создания объекта. Поиск и запуск 
компонентных программных модулей для создания фабрики класса — операция 
«дорогая», а создание объектов посредством Стещетяатсе — «дешевая». Поэтому 
лучше использовать одну фабрику класса для создания множества объектов. 

Что же это означает? А то, что мы все испортили, позволив функции Се! 1а55- 
ОБуес! самой создавать объекты С5расез р. Следовало бы сначала создать объект — 
фабрику класса, а уж потом вызвать Стежетяаисе, чтобы фабрика класса (объек- 
тов) сконструировала собственно объект — космический корабль. 

Сделаем все по правилам. Во-первых, объявим новый класс С5расезрЕасютгу. 
Пусть для простоты он будет производным от /С!а5зЕастоту, чтобы не связываться 
с вложенными классами. Кроме того, напишем код учета ссылок: 


ЗЕгисЕ ТС1аз$Расфогу : риб11с ТУпКпомп 
{ 
У1гЕца1 ВООЕ СгеафеТпзфапсе(1п& п1149, \019** рр\у0б7) = 0: 
# 
С1аз$ Сбрасезп1рРасфогу : риб11с ТС1аззРасфогу 
{ 
рг1уате: 
ОмОАО пм_дмВее 
ри611с: 
СЗрасезпарРастогу() { м_дмВее = 1; } 
// функции Т/пкпомп 
УтгЕиа1 ВООЕ ОцегуТпфегРасе(111& п119, у019** рр\0Б}.): 
У1гфиа1 ОМОВО Адавет(); 


Чтобы не путаться, можно считать, что у каждого СОМ-класса имеется «фабрика» для 
создания объектов данного класса. — Прим. перев. 


На самом деле /С/а55Еасюту и/или возникшие позже аналогичные ему интерфейсы 
поддерживаются фабрикой класса всегда. — Прим. перев. 
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\1гфиа1 ОМОВО Ве1еазе(); 
// функции ТС1аззРасфогу 
У1гфиа1 ВООЕ СгеатеТпзТапсе(1п& п1Т14, \014** рр\06)); 


Затем напишем функцию-член СтещетяЯаисе: 


ВОО. СЗрасезп1рЕастогу: : СгеатеТпзтапсе(1п{& п119, \№0149** рру0Ь)) 
{ 

СЗрасезй1р» р06] = пем СЗрасезН1р(); 

Тупкпомп* рУпк = &р06]->т_хМо{1оп; 

гефигп рИУпк->ОцегуТптегтасе(п11а, рру0ь1); 


И, наконец, создадим функцию Се 1а55ОБуе, которая конструирует объект — 
фабрику класса и возвращает указатель на интерфейс /С1а55Еасюту: 


ВООЕ бетС1а$$06)ест(1п{& пС1$14, 1п%& п114, \0149** рру06)) 
{ 
АЗЗЕВТ(пС1$14 == СЕЗТО_СЗрасезй1р); 
АЗЗЕВТ ((п119 == ТТ0_Т/пкпомп) 1! (1119 == ТТО_ТС1аззРасфогу)); 
СЗрасезп1рЕасфогу» р0Б] = пем СЗрасези1рРасфогу(); 
*рру0Ь] = р06}; // ТпКпомп* = ТС1аззРасфогух = СЗрасези1рРасфогу* 


Классы С5расезр и С5расезрЕасюгу работают в тандеме и совместно исполь- 
зуют один идентификатор класса. Теперь клиентский код (без проверки ошибок) 
выглядит так: 


ТМо{1оп» рМот; 

1\М1$иа1* р\13; 

ТСЛаззРастогу» рЕас; 

ветС1а$$06) ес+ (СЕЗТО_СЗрасезй1р, ТТО_ТС]аззРастогу, (\014**) &рРас); 
рЕас->СгеатеТпз{апсе (ТТВ_ТМот10п, &рМот); 

рМот->ОиегуТптегРасе (ТТО_Т\1$иа1, (\019**) &р\1$); 

рМот->-71у(); 

р\1$->01$р1ау(); 


Обратите внимание: класс СбрасезрЕасюту реализует функции Ад@Ке/и Кееазе. 
Это необходимо потому, что они — чисто виртуальные функции базового класса 
Юптвпоилт. Мы задействуем их на следующем этапе разработки программы. 


Класс ССтаТагде! 


Написанный нами код все еще далек от настоящего МЕС СОМ, но, прежде чем 
перейти к реальному программированию, мы сделаем еще один небольшой шаг 
в развитии нашей модели СОМ. Как вы, наверное, догадываетесь, кое-какой код и 
данные можно «вынести за скобки» наших СОМ-классов, моделирующих косми- 
ческий корабль, и включить в новый базовый класс. Так и делается в библиотеке 
МЕС, где таким базовым классом является ССтаТатсе! — стандартный базовый класс 
для классов документов и окон. В свою очередь ССтаЯТапзе! наследует классу СОБес. 
Вместо настоящего класса мы используем СбйпшщеастяТатвеь, в который выне- 
сем самый минимум — логику учета ссылок и переменную-член 7 аиКе/ Функ- 
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ции ЕметиеАаЯКери ЕжегиКе[еазе класса СйтшишеастяТатве предназначены для 
вызова из производных СОМ-классов. В связи с использованием сстаТатсе! мы 
поставим СзрасезрЕасюту в один ряд с С5расез р и реализуем интерфейс /С/а55- 
Еасюту как вложенный класс. 

Можно «вынести за скобки» и некоторые универсальные функции класса С5расе- 
5р. Функцию Оиегуйиет асе можно «делегировать» вложенными классами вспо- 
могательной функции внешнего класса ЕмегтиаЮиегуиет асе, вызывающей Ежеттай- 
лааКе). Каждая функция Омегуиехасе вызывает АЧЯКе/, но Стешетяатсе после 
ЕжетпаЮиетуиет асе вызывает функцию ЕжетийВееазе. Теперь, когда функция 
Стешетяатсе возвратит нам первый указатель на интерфейс, счетчик ссылок на 
объект «космический корабль» будет равен 1. Следующий вызов Оиегутеткасе 
увеличит счетчик до 2, и тогда для удаления объекта клиенту придется вызвать 
Каеа5е дважды. 

И еще одно замечание. Мы сделаем фабрику классов глобальным объектом — 
тогда нам не придется вызывать ее конструктор. Когда клиент вызовет Аееабе, 
проблем не возникнет, поскольку счетчик ссылок фабрики классов (когда клиент 
получает указатель на нее) равен 2. (Конструктор С5расезрЕасюку устанавлива- 
ет счетчик в 1, а ЕжетаЮиетуиет асе, вызванная из СеказзОБесь, увеличивает 
его до 2.) 


Пример Ех22а: «игрушечная» СОМ 


Листинги на следующих страницах содержат код программы Ех22а — «модели 
СОМ». Это текстовое (консольное) \/т32-приложение, не использующее МЕС, 
которое создает с помощью фабрики классов объект Сбрасезр, вызывает функ- 
ции его интерфейсов и освобождает объект. Файл Имегасе.В содержит объявле- 
ния базового класса СбйтшеейстяТатре и интерфейсов, используемых как кли- 
ентом, так и компонентом. В заголовочном файле 5расезЫр.В хранятся объявле- 
ния классов космического корабля, используемые компонентной программой. Файл 
Зрасезмр.срр — это и есть компонент, реализующий Се!аззОБеси. СНепе.срр — 
клиент, вызывающий СеС1а55ОБес. Определенное «жульничество» здесь в том, что 
код как клиента, так и компонента скомпонован в одной исполняемой програм- 
ме — Ех22а.ехе. Поэтому нашей «игрушечной» СОМ не требуется устанавливать 
связь в период выполнения. (Как это делается, вы узнаете чуть позже.) 


охожим на код МЕС 


ндегше 110 ТС1авзРаскогу 1. 
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Настоящая СОМ с применением МЕС 


Поиграли, и хватит: теперь мы готовы переделать пример с космическим кораб- 
лем для истинной СОМ. Но сначала мы познакомимся с функцией СобеСа5ОБесь, 
затем выясним, как СОМ использует реестр Х/Лп4оуз при загрузке компонента, в 
чем разница между внутренним (т-ргосе$$) (РТ) и внешним (оци-оЕ-ргосез$) (ЕХЕ 
или суррогатной РИ.) компонентом и, наконец, освоим МЕС-макросы, поддержи- 
вающие вложенные классы. 

В резульгате мы должны получить ОИ/-компонент на базе МЕС, содержащий 
весь код С5расезрр, в том числе интерфейсы /Мойоп и ГУбие. Клиентом будет 
обычное МЕС-приложение. Оно будет загружать компонент и работать с ним при 
выборе пользователем соответствующей команды в меню. 


СОМ-функция СобеС1!а$5ОЩес: 


В нашей модели мы использовали фиктивную функцию СеС/я55ОБес. В настоя- 
щей СОМ применяется глобальная функция Собе а ОБуес. [Со означает сотро- 
пепг обес! (компонентный объект).] Сравните следующий прототип с уже рассмот- 
ренной функцией Се а5$ОБесй 


ОТОАРТ СобетС1а$$06)ест(ВЕРСЕЗТО гс1$1а, ОМОАО 9мС1$Соптехе, 
СОЗЕВМЕВТМЕО» рЗегуегТпРо, ВЕРТТО г119, ЕРУОТО* рру0Ьу); 


Указатель на интерфейс возвращается через параметр рроов};, а р5етрейтю — 
это указатель на компьютер, на котором находится объект класса (МЛ, если это 
локальная машина). Параметры типа КЕЁС151) и КЕЕПО — ссылки на 128-разряд- 
ные глобально уникальные идентификаторы (э1оБаПу ипаие 14епийегз, СОТ) 
СОМ-классов и интерфейсов. $ТОАР! означает, что функция возвращает 32-раз- 
рядное значение типа НКЕЗТ. 

Стандартные СОТ (например, СОТО интерфейсов, уже созданных М!сгозой) 
определены в \/пао\5-библиотеках, динамически связываемых с вашей програм- 
мой. Произвольные СОТО, например для объектов — космических кораблей, дол- 
жны определяться в программе так: 


// $692003А4-С689-11СЕ-В337-88ЕАЗ6ОЕЭЕАЕ} 
Зфа{1с сопзф ТТО Т10_ТМо{10п = {0х692903а4, 0хс689, Ох} 1се, 
{0х63, 0х37, 0х88, Охеа, 0х36, Охае, 0х9е, 0х4е}}: 
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Если параметр 4шССотелх! равен СУСТХ_ПУРКОС_$ЕКУЕК, то СОМ ищет ОМ, 
аесли СЗСТХ_ПУРКОС_НАМОГЕЕ — то ЕХЕ. Эти две константы могут задаваться и 
одновременно (через оператор ОК): для выбора либо ОШ, либо ЕХЕ, исходя из 
соображений производительности. Например, внутренние серверы — самые бы- 
стрые, так как располагаются в адресном пространстве самой программы. Вза- 
имодействие с ЕХЕ-серверами происходит гораздо медленнее, поскольку межпро- 
цессные вызовы предусматривают как копирование данных, так и многочислен- 
ные переключения контекстов потоков. Возвращаемый результат — это значение 
типа НВЕЗОГТ, равное 0 (МОЕККОК) при благополучном завершении функции. 
вова 
Примечание Другая СОМ-функция — СоСтежетяатсе — объединяет в себе 

функциональность СобеСаз$ОБесе и 1Аа5Еасоту::Стешетяаисе. 


СОМ и реестр МИпаом!$ 


В программе Ех22а компонент и клиент статически связаны друг с другом, чего в 
действительности не бывает: компонентом является или ОМ, или отдельный ЕХЕ- 
файл. Когда клиент вызывает совеа$5ОБесЕ СОМ ищет соответствующий ком- 
понент, расположенный где-то на диске. Как же СОМ устанавливает связь между 
клиентом и компонентом? Она ищет уникальный 128-разрядный идентификатор 
класса в реестре. Следовательно, этот класс должен быть зарегистрирован на ва- 
шем компьютере. 

Запустив редактор реестра Везеай (Вере@32 в Мисгозой УИпаож$ МТ), вы уви- 
дите разделы идентификаторов классов (рис. 22-1), одни из которых представля- 
ют классы, связанные с РЦ, (пргос$егуег32), а другие — с ЕХЕ (Госа5егуег32). 
Функция Собеа5ОБес+ находит в реестре нужный идентификатор класса и загру- 
жает требуемый ОШ- или ЕХЕ-модуль. 


|-1С25864-3097-1102-А5С5-00С04Е796884} 
(-103РР84-4329-5275-АР69-0020А2С36Е79}, 
|-10778Р0-01АА-1102-А02Е-00600832С51Е} 
{Р10С95А0-ОВА7-11се-А166-00А4004С065С}. 
: ‚осабегуег32 
[Е1Е752С3-Е072-1100-ДЕР6-00С047В6ОО2С}; 


В оегац — ВЕб_52 МООЕМСР.ММСРосСолйд.1 


'2468580-аЁ8а-1190-8212-00с04#с32с45}. 
3 1пргосбегуег 32: 


{422675С6С-99Е6-4010-ВЕАО-9781266ВО9ЭСЕ} 
3} {Е2762За0-Б2а1-11се-ае4-00а200445589}; 
: {127623а1-62а!-1 1се-ае4с-00аг00445589} 
3 {Е27СЕ9З0-4САЗ-1101-АРЕ2-006097С94284} 
3 {Е280867А-0081-1103-В8Е8-0040С981 АЕЕВ} 
4: 


Рис. 22-1. Разделы четырех идентификаторов классов в реестре 


Что делать, если вы не хотите отслеживать эти кошмарные идентификаторы в 
своей программе-клиенте? Нет проблем. СОМ поддерживает в своей регистраци- 
онной базе данных записи и другого типа — вполне читабельные идентификаторы 
программ, преобразуемые в соответствующие идентификаторы классов (рис. 22-2). 
Поиск в базе данных и преобразование выполняет СОМ-функция С15/РЕтотРтоя Ш. 
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эрака\ИФдез. 550ВбИЧСЕИ,3 
55Оака\Иае5. 55ОВбИВСЕИАРЕ. 3 ‚| 95 (Оегау®) ВЕб_57 {08Е35204-8Е91-11СЕ-90ЕЗ-00А400488851}. 


ЭТСйепЕ,5ТСйегЕ 
ЭТСИеге, 5ТСйегЕ, 1 


УктеатОБесЕ, Маррег.7 


Рис. 22-2. Читабельные идентификаторы программ в реестре 


Первый параметр функции С1$ШЕтотРтоеШ — строка с идентификатором 
программы, но это необычная строка. Здесь вы впервые в СОМ столкнетесь с 
2-байтовыми символами. Все строковые параметры СОМ-функций (кроме РАО) 
являются указателями типа ОГЕСНАК* на строки Отисо4е-символов. Теперь ваша 
жизнь усложнится из-за постоянного преобразования «двухбайтовых» строк в 
обычные и наоборот. Чтобы получить константу — строку 2-байтовых символов, 
ставьте перед строковым литералом символ Г: 


СЕ$ТОЕготРго9Т0(1"Зрасезй1р”, &с1$19); 


С возможностями МЕС по преобразованию Отисоде-строк вы начнете знако- 
миться с главы 253. 

Как же регистрационная информация попадает в реестр? Можно запрограм- 
мировать приложение компонента так, чтобы оно вызывало УЛп4оу\-функции, 
напрямую модифицирующие реестр. В МЕС для них предусмотрена удобная обо- 
лочка — функция СО/еОБесасютгу::ОращеКеяуАЙ, которая находит в програм- 
ме все глобальные объекты — фабрики класса и регистрирует их имена и иден- 
тификаторы классов. 


Регистрация объекта в период выполнения 


Вы только что видели, как реестр используется для регистрации СОМ-классов, 
хранящихся на диске. Объекты — фабрики класса тоже надо регистрировать в 
памяти для внешних серверов, и очень жаль, что термин «регистрировать» употре- 
бляется в обоих контекстах. Объекты в модулях внешних компонентов регистри- 
руются в период выполнения вызовом СОМ-функции СоКеязяетСа55ОБуесь и эта 
информация сохраняется системными ОЮЫ-модулями УЛп4оу$ в оперативной 
памяти. Если фабрика зарегистрирована в режиме, разрешающем одному экзем- 
пляру сервера создавать более одного СОМ-объекта, то при вызове клиентом 
СовеазОБтесЕ СОМ использует существующий процесс, а не создает новый. 


Вызов СОМ-клиентом внутреннего компонента 


Мы начнем с ОМ, а не с ЕХЕ-компонента, так как в этом случае взаимодействие 
программ проще. Приведем псевдокод, поскольку мы будем работать с МЕС-клас- 
сами, скрывающими многие детали. 


сом 


Клиент 


сом 


ОЕЕ компонента 


Сом 


ОЕ: компонента 


сом 


Клиент 


ЕЕ компонента 


Клиент 


ОЕ компонента 


Клиент 
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СЕ$ТО с1$19а; 

ТСЛаззРасфогу* рС1Е; 

Ппкпомп» рупк; 

С01п1{1а117е(№11); // инициализация СОМ 
СЕ$ТОЕготРгодТО("<имя_компонента>", 81314); 


По параметру “<имя_компонента>" ищет в реестре идентификатор класса 


Собе{С1а$$06)ест(с1$19, СЕУСТХ_ТМРВОС_ЗЕВУЕА, МЕ 
ТТО_ТС1аззРасфогу, (\014**) &рС1Р) 


По идентификатору класса ищет компонент в памяти 
11 (ОЕЕ компонента еще не загружена) 

{ 

Считывает имя файла 011 из реестра 

Загружает ОЁЁ компонента в память процесса 


} 


1 (компонент только что загружен) 

{ 

Создаются глобальные объекты-фабрики классов 
Вызывается Тп1ЕТи$тапсе для БЫ. (только в МЕС) 


} 


Вызывает из 011 глобальную экспортируемую функцию 0116е{С1а$$06 ест 
со значением СЕ$ТО, переданным ранее в Собе{С1аз$06ес+ 


0116е{С1аз$06]есф возвращает ТС1аззРастогух 
Возвращает клиенту ТС1аззРасфогу* 


рС1т->СгеатеТпзфапсе (МЕ, ТТО_ТИпкпоми, (\019**) &рИпк): 
Вызывается функция фабрики классов СгеатеТпзТапсе 
(напрямую, через таблицу виртуальных функций компонента) 
Создается объект класса “имя_компонента" 

Возвращается указатель на запрошенный интерфейс 


рС1+->Ве1еазе(); 
рУпк->Ве1еазе(); 


Через таблицу виртуальных функций вызывается Ве1еазе для объекта 
класса “<имя_компонента>" 

11 (<счетчик_ссылок> == 0) 

$ 

Объект самоуничтожается 


} 


СоЕгее/пизед916гаг1ез(); 
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ЕЕ де одно емкое 
сом Вызывает из ОЫ: глобальную экспортируемую функцию 011СапИп1оад№ м 


ОЕ компонента Вызвана 011Сап/п1оад9№ м 
1 (все созданные ОЕЁЕ объекты уничтожены) { 
гефигп ТВОЕ; 


Клиент (С0/п11111а117е(); // перед самым завершением СОМ освобождает О, 
// если 011Сап/п1оа9№м возвратила ТВИЕ 


сом Освобождает ресурсы 
Клиент Завершает работу 


ОН: компонента \1п490м$ выгружает О, если та еще загружена и не используется 
другими программами 


Обратите внимание на ряд особенностей. Во-первых, в ответ на вызов клиен- 
том Собеа5$ОБес! из РИ. вызывается экспортируемая функция РИСеС1а5$ОБуеса. 
Во-вторых, возвращаемый адрес интерфейса фабрики классов на деле — физи- 
ческий адрес' таблицы виртуальных функций фабрики классов в О. И в-треть- 
их, клиент вызывает Стешетяапсе или любую другую функцию интерфейса на- 
прямую, через таблицу виртуальных функций компонента. 

Связь, которую устанавливает СОМ между ЕХЕ-клиентом и ОИ .-сервером, весьма 
эффективна — так же, как и вызов виртуальной функции С++ внутри процесса; плюс 
к этому выполняется контроль типов при компиляции. Единственная «накладка» — 
дополнительная операция, связанная с поиском идентификатора класса в реест- 
ре при первой загрузке О. 


Вызов СОМ-клиентом внешнего компонента 


Связь с отдельным ЕХЕ-компонентом через СОМ сложнее, чем связь с РШ.-ком- 
понентом. ЕХЕ-компонент находится в другом процессе или даже на другом ком- 
пьютере. Но не волнуйтесь. Пишите программы так, будто всегда есть прямая связь. 
О деталях позаботится СОМ посредством своей удаленной архитектуры, где обычно 
применяется ВРС. 

В БРС клиент обращается с вызовами к особой-Р, называемой ирокси (ргоху). 
Та в свою очередь передает поток данных заглушке (за), которая представляет 
собой РИ. в процессе компонента. Когда клиент вызывает функцию компонента, 
прокси уведомляет об этом заглушку, отправляя программе компонента сообще- 
ние, которое обрабатывается в ней скрытым окном. Механизм преобразования па- 
раметров в поток данных и обратно называется маршалингом (татзВаШпэ). 

При использовании стандартных интерфейсов (т. е. разработанных самой Мсго- 
50), таких как /С/а5$Еастоту и [Ретз#51 [с этим интерфейсом мы познакомимся при 
рассмотрении постоянства (регз1(епсе) в СОМ], код прокси и заглушки, реализу- 


1 Точнее, виртуальный адрес в адресном пространстве клиентского процесса. — Прим. 


перев. 
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ющий маршалинг, находится в УЛп4о\/з-библиотеке ОТЕАОТ3 2.01. Если же вы 
разрабатываете собственные интерфейсы, такие как /Мойоп и Убиа/, то писать коды 
прокси и заглушки придется самостоятельно. Но к счастью, теперь для построе- 
ния этого кода достаточно определить интерфейсы на специальном языке опре- 
деления интерфейсов (Пиеасе Рейт оп Гапзиазе, ТГ.) и скомпилировать код, 
создаваемый компилятором МПТ, (М1сгозой Иицегасе Рейп!оп Тапеиаее). 

Теперь мы приведем псевдокод, описывающий взаимодействие ЕХЕ-клиента с 
ЕХЕ-компонентом. Сравните его с тем, что было показано для ОШ. Обратите вни- 
мание, что вызовы со стороны клиента совершенно одинаковы. 


Клиент СЕ$ТО с1$19; 
ТСЛаз$Расфогу» рС1Р; 
Пупкпомп» рУпк 
Со1п1{1а117е(№11); // инициализация С0М 
СЕ$ТОЕготРгодТО("<имя_компонента>", &с1$149): 


сом По параметру “<имя_компонента>" ищет в реестре идентификатор класса 


Клиент СобетС1а$$06]ес{(с1$19, СЕ$СТХ_ТМРВОС_ЗЕВУЕВ, МИ, 
ППО_ТСЛаззРасфогу, (\%014**) &рС1г): 


сом Ищет компонент в памяти по идентификатору класса 
11 (ЕХЕ-файл компонента еще не загружен или нужен, его новый экземпляр) 
{ 
СОМ считывает имя ЕХЕ-файла из реестра 
Загружает ЕХЕ компонента в память 


ЕХЕ-файл 1 (только что загружен) { 

компонента Создаются глобальные объекты-фабрики классов 
Вызывается Тп1{ТизТфапсе (только в МЕС) 
(С0111{1а117е( Ми): 


Тог (для каждого объекта-фабрики класса) 
{ 
Сове91$тегС1аз$06ес{(...): 
Возвращает ТС1аззРасфогу*х в С0М 


} 

сом Возвращает клиенту указатель на запрошенный интерфейс 
(указатель для клиента не совпадает с указателем на интерфейс 
компонента) 

Клиент рС1т->СгеафеТптзфапсе(МИЕ, Т1Т0_ТУпКпомп, (№019**) &рупк); 

ЕХЕ-файл Вызывается СгеафеТпз{тапсе фабрики класса 

компонента (косвенно, через маршалинг) 


Создается объект класса “имя_компонента" 
Возвращается указатель на запрошенный интерфейс (косвенно) 


о биче банный часиблаы бан 
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Клиент рС1т->Не1еазе(); 
рУпк->Не1еазе(); 


ЕХЕ-файл Косвенно вызывается Не1еазе для объекта класса “имя_компонента” 
компонента 1 (счетчик_ссылок == 0) 
{ 
Объект самоуничтожается 
} 
1! (все объекты освобождены) 
{ 
Корректное завершение работы компонента 


Клиент С0\п11111а112е(); // непосредственно перед завершением 

сом Вызывает Ве1еазе для всех объектов, не освобожденных клиентом 
ЕХЕ-файл Завершает работу 

компонента 

сом Освобождает ресурсы 

Клиент Завершает работу 


Как видите, СОМ играет важную роль во взаимодействии клиента и компонента. 
СОМ поддерживает в памяти список фабрик классов, находящихся в активных ЕХЕ- 
компонентах, но не следит за отдельными СОМ-объектами типа Сбрасез р. Такие 
объекты сами заботятся о своем уничтожении через механизм даЯКеуКееаде. СОМ 
также участвует в завершении клиента. Если клиент использует ЕХЕ-сервер, СОМ 
прослушивает коммуникационный канал связи клиента с сервером, отслеживая 
счетчик ссылок на каждый объект. При завершении клиента СОМ отключается от 
объектов компонента, что в определенных условиях вызывает их освобождение. 
Но не полагайтесь на это. Перед завершением обязательно позаботьтесь, чтобы 
ваша клиентская программа освободила все указатели на интерфейсы. 


МЕС-макросы для интерфейсов 


В примере Ех22а вы видели, как используются вложенные классы при реализа- 
ции интерфейсов. Библиотека МЕС содержит набор макросов для автоматизации 
этого процесса. В объявлении класса С5расезр р, производного от настоящего МЕС- 
класса ССтаТагре, присутствуют следующие макросы: 


ВЕСТМ_ТМТЕВРАСЕ_РААТ(Мо1оп, ТМо+10п) 
ЭТОМЕТНОВ_(\019, Р1у) (); 
ЭТОМЕТНОВ_(1п1&, бетРоз1410п) (): 

ЕМО_ТМТЕВРАСЕ_РААТ(Мо{10п) 


ВЕСТМ_ТМТЕВРАСЕ_РААТ(\1$иа1, 1\1$иа1) 
УТОМЕТНОВ_(\014, О1зр1ау) (); 
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ЕМО_ТМТЕВРАСЕ_РАВТ(\1$ца1) 


РЕСГАВЕ_ТМТЕВЕАСЕ_МАР() 


Макросы ГУТЕКРАСЕ_РАКТ порождают вложенные классы, добавляя к первому 
параметру префикс Х, чтобы сформировать имя класса, и т_х — чтобы образо- 
вать имя внедряемого объекта. Эти макросы генерируют прототипы заданных 
функций интерфейса, а также прототипы Оиегуриетасе, АааКеГи Каеазе. 

Макрос РЕСГАКЕ_ПУТЕКЕАСЕ_МАР порождает объявления для таблицы, содер- 
жащей идентификаторы всех интерфейсов класса. ССтаТатве::ЕжметпаЮиег)- 
Гиетасе использует эту таблицу для получения указателей на интерфейсы. 

В файле реализации С5расезЬр нужны макросы: 


ВЕСТМ_ТМТЕВЕАСЕ_МАР(СЗрасезй1р, ССтаТагдет) 
Т№ТЕВРАСЕ_РАВТ (С5расезй1р, ТТО_ТМоф1оп, Моф1оп) 
ТМТЕВРАСЕ_РАВТ (СЗрасезп1р, ТТО_Т\1$иа1, \1зиа1) 

ЕМО_ТМТЕНЕАСЕ_МАР() 


Они создают таблицу интерфейсов, используемую функцией ССтаТатсе!::Ежет- 
пе-Оиетуиет асе. 


Типичная функция-член интерфейса выглядит так: 


ЭТОМЕТНООТМР_(\014) СЗрасезй1р: :ХМо+1от: :Е1у() 
{ 
МЕТНОО_РАОГОСУЕ (СЗрасезй1р, Мот1оп) 
рТ11$->т_пРо$110п += 10; 
гефигп; 


Не забудьте реализовать все функции всех интерфейсов, в том числе Оиегуие- 
Ласе, АааКе[и Кееа5е. Последние три функции могут делегировать вызовы функ- 
циям из ССтаТатое. 


Примечание Макросы 5ТОМЕТНОР_ и 5ТОМЕТНОРМР_ объявляют и реализу- 
ют функции, передающие параметры по правилам __ $19сай, как того 
требует СОМ. В первом параметре этих макросов определяется тип воз- 
вращаемого значения. В двух других макросах — 5ТЮМЕТНОР и 5ТОМЕ- 
ТНОМШМР — подразумевается тип НКЕЗИЕТ возвращаемого значения. 


МЕС-класс СОеОШес!Расогу 


В примере с моделью СОМ класс СзрасезрЕясюту был жестко запрограммиро- 
ван на генерацию объектов С5расезр. В МЕС применяется метод динамического 
создания объектов. Благодаря этому единственный класс, удачно названный СОеОБ- 
ЛесШасюту, способен создавать объекты любого класса, указанного в период вы- 
полнения программы. Все, что от вас требуется, — вставить в объявление класса 
макросы, подобные этим: 


ОЕСЕАВЕ_ОУМСВЕАТЕ(СЗрасезв1р) 
ОЕСЕАВЕ_ОТЕСВЕАТЕ (СЗрасезН1р) 
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В файле реализации класса нужно написать макросы такого вида: 


ТМРЕЕМЕМТ_ОУМСВЕАТЕ(С$расезй1р, ССмаТагдет); 

// {$692003АЗ-С689-11СЕ-В337-88ЕАЗ6ОЕЭЕ4Е} 

ТМРЕЕМЕМТ_ОТЕСВЕАТЕ( СЗрасезй1р, “Зрасезй1р”, 0х692403а3, 0хс689, 0х11се, 
0х63З, 0х37, 0х88, Охеа, 0х36б, Охае, 0х9де, 0х4е) 


Макросы РУМСКЕАТЕ активизируют стандартный механизм динамического 
создания объектов. Макросы ОГЕСКЕАТЕ объявляют и определяют глобальный 
объект класса СОеОБесасюту с указанным уникальным СТ$ТО. В ОИ -компоненте 
экспортируемая функция РИбеС1а55ОБесь, используя глобальные переменные, 
определенные макросами ОГЕСКЕАТЕ, отыскивает нужный объект — фабрику клас- 
сов и возвращает указатель на него. В ЕХЕ-компоненте инициализирующий код 
вызывает статическую функцию СОеОБесасюту::КежяетАЙ, которая ищет все 
объекты-фабрики и регистрирует каждый из них вызовом СоКезяетЦаз$Овлеси. 
Функция КезЯетАЙ вызывается и при инициализации ОШ, но в этом случае она 
просто устанавливает флажок в объекте-фабрике (или объектах-фабриках). 

Мы только коснулись проблемы поддержки СОМ в МЕС. Подробности вы най- 
дете к книге Шеферда и Уингоу «МЕС Ицегпа|5» (АЧА1зоп-\е$1еу, 1996). 


Поддержка внутренних СОМ-компонентов 
со стороны мастеров 


Мастер МЕС ОШ, У12ага не совсем подходит для создания ПИЛ, СОМ-компонентов, 
но его можно «обмануть», попросив сгенерировать обычную РИ, с поддержкой 
АшотаНоп (для этого установите флажок АшютаЧоп на странице АррИсайоп 
56198). В главном файле проекта представляют интерес такие функции: 


ВОО СЕх226Арр: : Тп1Тпзтапсе( ) 
{ 
СИ1пАрр: : Тп1ТизТапсе(); 
// Вед1$ег а11 ОЕЕ зегуег (Расфог1ез) аз гипп1п9. ТИ1$ епаб1ез пе 
// О\Е 116гаг1ез фо сгеафе обес Ргот офПег арр11сат1опз. 
С01е06] естРасфогу: :Вед1$егА11(); 
гефигп ТВИЕ; 
} 
// 0116е1С1а$$06)ес{ - Вефигпз с1азз Расфогу 
ЭТВАРТ 0116е1{С1а$$06]ес(ВЕРСЕЗТО гс1$19, ВЕРТТО г119, ЕРУОТО»* рру) 
{ . 
АРХ_МАМАСЕ_5ТАТЕ( АРхбет5та{1сМоди1е тате()); 
гефигп АЁхО11бе+С1а3306]ес{(гс1$19, г119, ррм); 
} 
// 011Сап/п1оа9№ м - А110ом$ СОМ $0 ип1оаа ОЕ 
ОТВАРТ 011Сап/п1оаа№ом (№014) 
х 
АРХ_МАМАСЕ_5ТАТЕ( АРхбет5та{1сМоди1е тате()); 
гефигп АЁхо11Сап/п1оад9№м( ); 
} 
// 011Вед1$тегЗегуег - АЧЧ$ еп{г1ез фо {пе зузфет гед1$гу 
ЭТБАРТ 011Вед1з{егЗегмег(\01а) 
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АРХ_МАМАСЕ_ЭТАТЕ( АРхбе{5{а{1сМоди1е3{ате()); 
11 (!АГхО1евед1зтегТуреЕ 16 ( АРхбе{ТпзтапсеНапа1е(), _+119)) 
гефигп ЗЕЕЕВЕС_Е_ТУРЕЕТВ; 


1е (!601е06]естРастогу: : /рдафеве91$1гуА11()) 
гефигп ЗЕГЕНЕС_Е_СЁА$5; 


гефигп 5_0К; 
} 


// 011) пгедазфегегуег - Ветоуез епг1ез гот +пе зузтет ге91$тгу 
ОТОАРТ 011\пгед1з+егЗегуег(м014) 
{ 
АРХ_МАМАСЕ_ЗТАТЕ( АТхбет5та{1сМоди1е тате()): 
17 (!АРхОТе/пгед1$тегТуреЕ16(_+119, _м\егМадог, _м\егмМ1пог)) 
гетигп ЗЕЁЕРАЕС_Е_ТУРЕЕТВ; 


17 (!С01е06естРастогу: : /рдаевед1$1гуА11 (ЕАЕЗЕ)) 
гефигп ЗЕЕРВЕС_Е_С1А$5; 


гефигп 5_ОК 


Эти три глобальные функции экспортируются при помощи РЕЕ-файла проек- 
та. Вызов МЕС-функции позволяет гарантировать, что глобальные функции сде- 
лают все, что нужно РЫ.-модулю СОМ. Для обновления информации в системном 
реестре функции РИКез“ет$етиег и ОШ/пгевчет5етиет можно вызывать из програм- 
мы-утилиты. 

После создания заготовки проекта надо добавить средствами МЕС С!аз$ ХИлага 
в проект один или нескольких классов, объекты которых будут создаваться через 
СОМ. Для этого просто заполните поля имени класса, базового класса и имен 
файлов на странице Мате: 


| масоте 50 {Не МЕС С!а5$ МИгага 


ТН ‘и2ага а445 а Ча НаЕ прейёз Гот МЕС 0 убиг ргодесЕ, ОрНопз тау сВапде дерепл4 па 
оп ве Базе <а5 звескед. 


Вновь сгенерированный класс получит ряд элементов для поддержки Аию- 
тацоп, например, карты диспетчеризации (Фзрагсв тар), которые можно спо- 
койно удалить. Кроме того, из $ЧАЁх.В можно убрать и эти строки: 
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#1пс1иде <аЁход19$. > 
#1пс1и4де <аРхд1зр. > 


СОМ-клиенты на базе МЕС 


Написать клиентскую СОМ-программу на базе МЕС несложно. Вы просто создае- 
те обычное приложение с помощью МЕС АррИсанНоп УЛгагА и добавляете в 5(ААЁХ.В 
строку: 


#11с1и4е <атхо]1е. п> 
ав функцию-член /изяапсе класса приложения — оператор: 
АРХО1еТп1{(); 


Теперь можете написать код, вызывающий совеа55ОБес. 


Пример Ех225: внутренний СОМ-компонент, 
созданный на базе МЕС 


Пример Ех22Ь — обычная МЕС ОШ, содержащая настоящую СОМ-версию класса 
С5расез р, который вы видели в Ех22а. Файлы Ех22Ъ.срр и Ех22Ъ.В сгенерирова- 
ны МЕС РИ, УЛ2ага, как мы только что пояснили. В файле Ииегасе.В объявлены 
интерфейсы /Мойоп и Г/биа1. После текста файла Име!асе.В показан код класса 
С5расез р. Сравните его с кодом из примера Ех22а. Заметили, как за счет МЕС- 
макросов удалось уменьшить объем кода? Заметьте: учет ссылок и логику Оиегу- 
тетасе реализует МЕС-класс ССтаТатве. 


см. след. стр. 
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см. след. стр. 
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(соп5 спаг*) тг): 


Пример Ех22с: СОМ-клиент на базе МЕС 

Ех22с — это МЕС-программа, которая содержит настоящую СОМ-версию клиент- 
ской части примера Ех22а. Это сгенерированное МЕС АррИсаНоп \У/тага 5В1-при- 
ложение с добавлением операторов #тсшае для включения заголовочных фай- 
лов МЕС СОМ, а также с добавлением вызова АхО/еий для инициализации О. 
Команда брасезШр из меню Тез! обрабатывается функцией класса «вид», показан- 
ной в следующем листинге. В проект входит и копия файла компонента Ииегасе.В 


из Ех22Ъ. Оператор #тсшае для включения этого файла помещен в начало Ех22с- 
Уехусрр. 


\014 СЕх22с\1ем: :ОпТез{5расезп1р() 
{ 

СЕУТО с1$19; 

ЕРСТАЗЗЕАСТОВУ рС1г; 

ЁРУМКМОММ рУпк 

ТМо1оп» рМот; 

1Т\15иа1* р\15; 


НВЕЗИЕТ Пг; 
1 ((пг = : : СЕЗТОЕгомРГОоОТО(1"Ех226. Зрасезй1р”, &с1$19)) != МОЕВВОЯ) { 
ТВАСЕ( “ипаб1е +0 11па Ргодгат ТО - еггог = %х\п", Пг) 
гефигп; 
} 
1 ((пг = ::Собе*С1аз$06]ес{(с1$1а, СЕЗСТХ_ТМРВОС_ЗЕВУЕВ 
МЕ, ТТО_ТС1аззРасфогу, (№019 **) &рС1Р)) != МОЕВВОВ) { 
ТВАСЕ( “ипаб1е фо Р1п4а С15ТО - еггог = %х\п", Пг) 
гефигп; 


} 


рС1+->СгеатеТпзфапсе( МЕ, 110_Тпкпомп, (№\019**) &рИпк); 
рУпк->ОиегуТпегРасе(ТТО_ТМо%1оп, (\014**) &рМо{); // должны работать 
рмо+->ОиегуТптегРасе(ТТ0_Т\/1зиа1, (\019**) &р\1$); // все 3 указателя 
ТВАСЕ(“та1п: рупк = %р, рМоф = %р, р01$ = %р\п", рупк, рМоф, р\1$); 


// Тестируем все виртуальные функции интерфейсов 
рМот->Р1у(); 

111 пРоз = рМот->бе{Ро$110п(); 

ТВАСЕ( “пРоз = %4\п”, пРо$); 
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р\1$->01$р1ау(); 


рС1+->Не1еазе(); 

рУпк->Ве1еазе(): 

рМот->Не1еазе(): 

р\1$->Не1еазе(); 

АгхМеззадевВох ( "Тезф зиссеедед. Зее бебид м1паом Гог оифри*. "): 


Чтобы протестировать клиент и компонент, сначала запустите компонент для 
обновления информации в реестре. Это можно сделать с помощью нескольких 
утилит, но попробуйте использовать программу ВЕССОМР с компакт-диска. Вам 
будет предложено выбрать ОИ. или ОСХ-файл, а затем программа вызовет экс- 
портируемую функцию РИКевет$етоет из указанного файла. 

И клиент, и компонент выводят информацию о своей работе, используя мак- 
рос ТКАСЕ, поэтому вам потребуется отладчик. В частности, У151а1 $аАю МЕТ 
прекрасно подходит для запуска как клиента, так и компонента. В последнем слу- 
чае надо будет ввести полное имя исполняемого файла клиента. Но копировать 
РИ.-модуль не надо, так как \Лп4о\$ найдет его по информации в реестре. 


Вложение, агрегирование или наследование 


Обычно при программировании на С++ наследование применяют, чтобы вынес- 
ти универсальные функции в базовый класс для повторного использования. При- 
мер — класс СРегячетщЕтате (см. главу 14). 

В СОМ вместо наследования используют вложение (сомаштепи) и агрегиро- 
вание (азэгезаЧоп). Начнем с вложения. Допустим, мы расширили нашу модель 
космического пространства, предусмотрев в ней движение планет. Программируя 
на обычном С++, мы скорее всего написали бы базовый класс СОтЬйет, который 
инкапсулировал бы законы небесной механики. В СОМ же применяются внешние 
(ощег) классы Сбрасезр и СР/апе! и внутренний (1шпег) класс СОтфйег. Интер- 
фейс ГУбиа/ был бы реализован непосредственно во внешних классах, но интер- 
фейсы /Мойоп они делегировали бы внутреннему классу СОтЬйег. Резульгат выглядел 
бы примерно так: 


Шпкпоит С) 


Мзиа! С) 


ИМойопт С) 


Шпкпоит С) 


Миа! С) 


ИМонот (0) СОгЬйег 
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Заметьте: объект СОтьйет не знает, что содержится внутри объекта Сбрасез р 
или СР/апер, тогда как внешнему объекту, конечно же, известно, что в него встро- 
ен СО’фйет. Внешний класс содержит реализации всех функций своих интерфейсов, 
но функции из /Мойоп, включая Оцегу/тет/асе, просто вызывают одноименные 
функции внутреннего класса. 

Агрегирование сложнее, чем вложение. В этом случае клиент получает прямой 
доступ к интерфейсам внутреннего объекта. Вот вариант модели движения пла- 
нет в космосе, построенный на агрегировании: 


/Шпкпоит (внешний) С) 


ИИзиа! О) 


ИМовоп С) 


Шпкпоит (внешний) С) 


ИИвиа/ О) 


ИМовоп С) 


Как и при вложении, СОтЬйет встроен (вложен) в Сбрасезр и СР/апей. Допус- 
тим, клиент получил указатель на //5иа! для Сбрасезрр, после чего вызывает 
Оиегутетасе, чтобы получить указатель на /Мойоп. Используя для этого указатель 
на внешний /Откпошт, вы ничего не получите, так как класс СЗрасезр не под- 
держивает [Мойоп. Поэтому класс Сбрасезрр получает указатель на /Моноп от 
СОтЬйет с помощью указателя на внутренний Юиёпоилт (встроенный объект СО’Бйе». 

Теперь предположим, что у клиента есть указатель на /Мойоп, через который 
он вызывает Оиегушет/асе, чтобы получить указатель на Ибис. Внутренний объект 
при этом должен иметь возможность передать вызов внешнему объекту, но как? 
Давайте приглядимся к вызову функции Стещетяатсе в листинге примера Ех22с. 
Первый параметр в данном случае равен МИ. Если вы создаете агрегированный 
(внутренний) объект, этот параметр применяется для передачи указателя на /Фиё- 
поит внешнего объекта, который к тому времени уже должен существовать. Та- 
кой указатель называется внешним управляющим (сопиоШпе ипкпо\п). Класс 
СОтЬйет сохраняет его в одной из своих переменных-членов и использует при 
вызове Онегуйиет/асе для интерфейсов, не поддерживаемых СОтЬйег. 

Библиотека МЕС поддерживает агрегирование. У класса ССтаЯТагвей есть откры- 
тая переменная-член 72 рОше’Отйпоит, в которой хранится указатель на /Сиёпоит 
внешнего объекта (если данный объект входит в состав агрегата). Функции-чле- 
ны класса ССтАаТагве — ЕжегпаЮиегуриет расе, ЕжетиАаЯКе[ и ЕжетиВаеа$е — 
делегируют вызовы внешнему /О/ипошт (если он существует). Функции-члены 
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другой группы — ИшегиаЮиегутет асе, риетпАааКе! и пиетиКаеазе — ничего 
не делегируют. Описание МЕС-макросов, поддерживающих агрегирование, см. в 
МЕС Тесбтуса! Мое #38. 

Хотя агрегирование играет очень важную роль в СОМ (особенно при работе с 


диспетчером прокси), вам вряд ли придется использовать его в стандартных СОМ- 
приложениях. й 


2-5 нь аки йа —Й 


1 


ГЛАВА 


23 


Ащотайоп 


И: главы 22 вы уже знаете, что такое интерфейс. Вы также познакомились с двумя 
стандартными СОМ-интерфейсами /Отёпошт и 1С1а55Еасюту. Теперь вы готовы 
изучать прикладную часть СОМ, по крайней мере одну из ее составляющих — 
Ашотаноп, ранее известную как ОТЕ Ашоглацог. В этой главе мы рассмотрим СОМ- 
интерфейс Рбраср, позволяющий программам на С++ взаимодействовать с про- 
граммами на \У15иа1 Ваяс юг АррНсаНопз (УВА), а также с программами, написан- 
ными на других языках сценариев (зсирИпе 1апзиазе). Кроме того, Ирась игра- 
ет ключевую роль при размещении СОМ-объектов на ХеБ-странице. Взяв реали- 
зацию Дёраср из библиотеки МЕС, мы напишем на С++ программы компонента 
и клиента АшотаНоп, причем рассмотрим как внешние (о\-оЁ-ргосезз), так и 
внутренние (т-ргосе5$) компоненты. 

Но, прежде чем программировать Ашюотайоп на С++, вы должны знать, как 
пишет подобные программы весь остальной мир. В этой главе вы получите пред- 
ставление о УВА, реализованном в М!сгозой Ехсе!. Мы будем запускать из Ехсе! 
свои компоненты, а также вызывать Ехсе! из клиентской программы на С++. 


Создание компонентов С++ для УВА 


Отнюдь не все, кто программирует для УЛп4оу/з, собираются программировать 
на С++ и тем более углубляться в «дебри» СОМ. Если вы следили за событиями в 
отрасли последние несколько лет, то, верно, заметили тенденцию, что програм- 
мисты на С++ создают модули, допускающие повторное использование, а програм- 
мисты на языках более высокого уровня (У154а1 Ваз1с, УВА, языки \еБ-сценариев 
ит. п.) интегрируют эти модули в приложения. Вы можете стать участником та- 
кого «разделения труда», узнав, как сделать ПО доступным для языков сценариев. 
Одно из средств достижения этого, поддерживаемых библиотекой МЕС, — это 
АшотаНоп. Другое средство интеграции С++ и УВА — элементы управления АсНуехХ, 
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представляющие собой надмножество АцютаНоп, поскольку в них тоже приме- 
няется интерфейс ШРёбреср. Однако АсиуеХ-элементы порой просто излишни. 
Многие приложения, в том числе Мисгозой Ехсе|, поддерживают как компоненты 
АшотаНоп, так и АсйуеХ-элементы. Более того, все, что вы узнаете об АиотаНоп, 
можно применять при написании и работе с АсйуеХ-элементами. 

Успех АиютаНоп обеспечили два обстоятельства. Во-первых, УВА (или УВ 
$сйро — сейчас стандартное средство программирования в большинстве прило- 
жений М!сгозой, в том числе ога, Ехсе| и Ассез$, не говоря о самом У15иа| Вас. 
Все эти приложения поддерживают АиютанНоп, а значит, могут взаимодейство- 
вать с другими совместимыми с этим механизмом компонентами, в том числе с 
написанными на С++ и УВА. Например, можно написать на С++ программу, кото- 
рая будет использовать возможности У/ога в обработке текста, или компонент 
обращения матрицы, который вызывается из УВА-макроса в таблице Ехсе!. 

Во-вторых, десятки фирм предусматривают в своих приложениях интерфей- 
сы Ашотаноп, главным образом для программистов на УВА. Приложив минимум 
усилий, вы сумеете задействовать эти интерфейсы из С++, например, написать МЕС- 
программу, управляющую программой рисования М1сгозой \1910. 

АшотаНоп не предназначена исключительно для программистов на С++ и УВА. 
Ряд фирм уже объявил о создании совместимых с АшютаНоп Ва$1с-подобных 
языков, которые любой разработчик может лицензировать для включения в свое 
приложение, допускающее ту или иную степень программного управления. По- 
явилась даже версия ЗтаШа!К, поддерживающая АшоютаНноп. 


Клиенты и компоненты АшотаНоп 


При взаимодействии на основе АиотаНоп четко проявляется иерархия типа «ве- 
дущий — ведомый» (тазег — $ауе). Ведущий — это клиент (контроллер) Аиюта- 
поп [Ашкотайоп сНепе (сопиго|ег}], а ведомый — компонент (сервер) Аиютаноп 

[Ашотайоп сотропепи (зегуег)]!. Клиент инициирует взаимодействие, создавая 

объект компонента (для этого может понадобиться запуск программы компонента) 

или подключаясь к существующему объекту в уже выполняемой программе. Пос- 
ле этого клиент вызывает функции интерфейсов компонента и, закончив свои 
операции, освобождает интерфейсы. 

Вот несколько сценариев такого взаимодействия. 

Ш Ацотаноп-клиент на С++ использует в качестве компонента приложение М!сго- 
$0Ё или сторонней фирмы. Это приводит к исполнению УВА-кода в приложе- 
нии компонента. 

Ш Ашотаноп-компонент на С++ вызывается из приложения М!сгозой (или при- 

ложения на У151а! Вас), которое выступает в качестве клиента. Тем самым УВА- 

код создает объекты С++ и оперирует с ними. 

АшотаНоп-компонент на С++ используется клиентом С++. 


Ш Программа на У!5иа! Ваз1с обращается к приложению, которое поддерживает 
Ашотавоп, например к Ехсе!. В этом случае У!5иа| Ва$1с — клиент, а Ехсе] — 
компонент. 


' Можно считать, что «клиент», «контроллер» и «контейнер» в СОМ — это одно и то 


же. — Прим. перев. 
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МсгозоН Ехсе! — лучший \зца! Вас, чем сам М!зца! Вас 


Когда были написаны первые три издания этой книги, У15ча! Ваз!с мог быть кли- 
ентом Ацютанои, но не годился для создания компонента. Но с версии 5.0 У151а1 
Ваз!с позволяет писать и компоненты. Поначалу мы использовали М1сгозой Ехсе! 
вместо УВ только потому, что Ехсе! был первым приложением М!сгозой, поддер- 
живающим синтаксис УВА, и мог выступать в роли как клиента, так и сервера. Но 
теперь мы используем Ехсе|, может быть, потому, что хотим убедить программи- 
стов на С++, которые морщатся при одном упоминании о У150а1 Вас, приобрес- 
ти Ехсе| — хотя бы для того, чтобы вести учет своих гонораров. 

Настоятельно рекомендуем приобрести копию Ехсе! — настоящее 32-разряд- 
ное приложение из комплекта М!сгозой ОЁйсе. Оно позволяет писать в отдельном 
модуле УВА-код, осуществляющий доступ к ячейкам электронной таблицы в объек- 
тно-ориентированном стиле. В Ехсе! легко добавлять и такие визуальные элементы, 
как кнопки. Словом, забудьте о старых электронных таблицах, заставлявших вас 
втискивать макросы в ячейки. 

Эта глава — вовсе не учебник по Ехсе!, но мы включили в нее пример с рабо- 
чей книгой (\уогКБооК) Ехсе!. (Рабочая книга — файл, содержащий одну или не- 
сколько электронных таблиц и отделенный от них УВА-код.) Эта рабочая книга 
демонстрирует УВА-макрос, исполняемый по щелчку кнопки. Вы можете загрузить 
файл Вето.х!5 в Ехсе! из каталога \усррпе\Ех23а на компакт-диске или набрать 
его текст самостоятельно. На рис. 23-1 показана электронная таблица с кнопкой 


и тестовыми данными. 


Рис. 23-1. Электронная таблица Ехсё с применением УВА 


Выделите ячейки с А4 по А9 и щелкните кнопку Ргосез$ Со|. Программа на УВА 
«пройдет» по столбцу и заштрихует ячейки с числами, больше 10. На рис. 25-2 по- 
казан код макроса, который выполняет эту работу. В Ехсе! в меню Тоо!5 (Сервис) 
последовательно выберите команды Масго (Макрос) и У150а| Ваз1с ЕЧКог (Редак- 
тор \151а1 Вас) (быстрая клавиша АШ+Е11). Как видите, с этого момента мы ра- 
ботаем в стандартном окружении УВА. 
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м МсгозоЙ У5иа!Ваяс - Чето. 5 - [безе {Со 


—- | Зив РкосеззСо маи (} 
УВАРГо}есЕ (Фето. 6) Ро 01511 Асс1\еСе11.Уалае = "" 
Мстозой: Ехсе! ОБесЕз ТЕ Аст1уеСе11.Уа1це > 10 Твеп 
Зе1есс1оп.Тибек1ог.Рассеки = х1Сг133Скоз 


ь ТРЕМоНфоок = Е!1зе 


Зе1ест1о1.Тисек1ок.Рассеки = х1Мопе 
Ева ТЕ 
5е1ест101.0223е5(1, 0).Вапае ("41") .Зе1есь 


Рис. 23-2. УВА-код для электронной таблицы Ехсей 


Если вы хотите подготовить этот пример самостоятельно, сделайте следующее. 

1. Запустите Ехсе! с новой рабочей книгой, нажмите АЦ+Е11, а затем дважды 
щелкните 5Вее в левом верхнем окне. 

2. Наберите код макроса, показанный на рис. 23-2. 

3. Вернитесь в окно Ехсе|, выбрав в меню Ее команду Сюзе апа Вешги го М!сгозой 
Ехсе!. Выберите команду Тооаг (Панели инструментов) в меню \У1еу (Вид). 
Для вывода на экран панели инструментов Еогиа$ (Формы) отметьте флажок 
Роги (Формы). (Список доступных панелей инструментов можно получить, 
щелкнув правой кнопкой любую из находящихся на экране инструментальных 
панелей.) 

4. Щелкните элемент управления Вино (Кнопка) и создайте кнопку, перетащив 
ее в левый верхний угол таблицы. Назначьте этой кнопке макрос 5рее!.Ргосе$- 
сошти. 

5. Отрегулируйте размер кнопки и сделайте на ней надпись Ргосез$ Со! (рис. 25-1). 

6. Введите любые числа в столбец, начиная с ячейки А4. Затем выделите ячейки, 
содержащие эти числа, и щелкните кнопку, чтобы протестировать программу. 
Просто, правда? 

Проанализируем один из операторов Ехсе! УВА из нашего макроса: 


бе1ес&1оп. О1Рзет(1, 0).Вапде("А1”). $е1ес+ 


Первый элемент (5еесйоп) — это свойство не указанного явно объекта-при- 
ложения Ехсе!. Здесь подразумевается, что его значением является объект Капве, 
представляющий прямоугольный блок ячеек. Второй элемент (О][5ер) является 
свойством объекта Капве, который возвращает другой объект Капве, заданный двумя 
параметрами. Здесь возвращаемый объект Капве — блок из одной ячейки, начи- 


ГЛАВА 23 АшщотаНоп 501 


нающийся на строку ниже исходного Капве. Третий элемент (Капзе) — это метод 
объекта Каире, возвращающий еще один блок ячеек, — на этот раз левую верхнюю 
ячейку во втором блоке. И, наконец, метод 5@ес{ заставляет Ехсе! выделить ука- 
занную ячейку и сделать ее свойством 5ейесйоп приложения. 

По мере прохождения цикла рассматриваемый оператор смещает выделенную 
ячейку в таблице на следующую строку за одно повторение. К такому стилю про- 
граммирования надо привыкнуть, но игнорировать его нельзя — он очень попу- 
лярен в приложениях М1сгозой ОЁсе, где приходится обрабатывать массу доку- 
ментов. Главное, всеми средствами электронной таблицы и графического ядра Ехсе! 
теперь можно управлять из встроенной среды программирования. 


Свойства, методы и наборы 


Различие между свойством и методом в какой-то мере искусственно. По сути свой- 
ство — это некое значение, которое можно присвоить свойству и/или считать, как 
свойство 5есНоп приложения Ехсе!. Другой пример — свойство УПА, характерное 
для многих объектов Ехсе]. Часть свойств Ехсе! доступна только для чтения, но 
большинство можно и считывать, и устанавливать. 

У свойств вроде бы нет параметров, но у некоторых есть индекс, во многом 
аналогичный параметру. Он необязательно должен быть целым числом и может 
содержать более одного элемента (скажем, строку и столбец). Вы не найдете ин- 
дексируемых свойств в объектной модели Ехсе!, но Ехсе! УВА способен работать 
с индексируемыми свойствами в компонентах Ашотайоп. 

Методы более гибки, чем свойства. Они могут иметь несколько параметров (или 
вообще не иметь), присваивать или считывать данные объекта и выполнять ка- 
кие-то действия, скажем, открывать окно. 5е/ес! — пример метода, реализующего 
определенное действие. 

Ехсе! поддерживает оббъекты-наборы (соПесНоп оБ}ес{5), например объект $рееё5, 
возвращаемый свойством У\/огК5Вее!5 объекта Аррисайоп, который содержит все 
электронные таблицы активной рабочей книги. Чтобы получить конкретный объект 
Уотерее! из набора, можно использовать свойство Цет (с целочисленным индек- 
сом) или просто применить индекс непосредственно к набору. 


Интерфейсы АщотаНоп 


Вы уже знаете, что СОМ-интерфейс — идеальный способ взаимодействия двух 
УЛп9оу\з-программ, но вы знаете и то, что разрабатывать собственные СОМ-ин- 
терфейсы чаще всего по крайней мере непрактично. Ашотайоп предоставляет 
интерфейс общего назначения [025 рейср, удовлетворяющий программистов как на 
С++, так и на УВА. Наверное, вы уже догадываетесь, познакомившись с Ехсе! УВА, 
что этот интерфейс основан на объектах, методах и свойствах. 

Можно создавать СОМ-интерфейсы с функциями, имеющими параметры и 
возвращаемые значения любого заданного вами типа. Пример тому — /Мойоп и 
ПШИбзиа из главы 22. Но если вы собираетесь допустить к своему компоненту про- 
граммистов на УВА, спешка и небрежность недопустимы. Проблему взаимодей- 
ствия можно решить за счет одного интерфейса с единственной функцией-чле- 
ном, достаточно «сообразительной», чтобы поддерживать методы и свойства так, 
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как нужно УВА. Разумеется, в /ОёрейсЬ есть такая функция — Гтооке. Вызов [06- 
рась:1пооке используется для СОМ-объектов, с которыми могут оперировать 
программы и на С++, и на УВА‘. 

Теперь, надеемся, вы начинаете понимать задачи, решаемые АшотаНоп. Она 
пускает поток межмодульных взаимодействий по руслу ШёреисЬ::тооЁе. А как 
клиент впервые подключается к компоненту? Поскольку Поёрейсь — всего лишь 
еще один СОМ-интерфейс, то логика регистрации, поддерживаемая СОМ, приме- 
нима и в этом случае. Компонентами Ашотайоп могут быть как ОШ-, так и ЕХЕ- 
модули; доступ к ним возможен даже по сети посредством распределенной СОМ 
(РазшиЬщеа СОМ, РСОМ). 


Интерфейс /Ю/5расп 


ШРбрейсьЬ — «сердце» Амотайоп. Этот интерфейс, как и остальные стандартные 
СОМ-интерфейсы, полностью поддерживается за счет СОМ-маршалинга (т. е. ре- 
ализацию его маршалинга уже написали разработчики из М1сгозой) и библиоте- 
кой МЕС. В компоненте должен быть СОМ-класс с интерфейсом Рёрейср (и под- 
ходящая фабрика классов). Клиент получает указатель на /Рёрейсь так, как это 
принято в СОМ. (Как вы увидите дальше, большую часть работы за вас будут вы- 
полнять мастера и библиотека МЕС.) 

Вспомните, что [прое — главная функция-член ШРбрейсЬ. В интерактивной 
документации У151а1 5 ю МЕТ вы обнаружите у /Оёреись:тоове воистину кош- 
марный набор параметров. Но не думайте о них сейчас. Библиотека МЕС действует 
с обеих сторон вызова /игоёе, применяя схему вызова функций компонента на 
основе параметров карты диспетчеризации, которую вы определяете через мак- 
росы. 

Ттгоке — не единственная функция Шёреср. Другая функция, которую может 
вызвать контроллер, — сейр5ОД\атез. С точки зрения программиста на УВА свой- 
ства и методы имеют символьные имена, но программисты на С++ предпочита- 
ют более эффективные целочисленные индексы?. моойе задает свойства и мето- 
ды целыми числами, поэтому Сейр5О\атез очень полезна в начале программы, 
позволяя преобразовать все имена в индексы, если последние неизвестны при 
компиляции. Как вы уже видели, РёрейсЬ поддерживает символьные имена для 
методов. Но этот интерфейс поддерживает символьные имена и для параметров 
методов. Эти имена функция Сейр5$О/Уатез возвращает вместе с именем метода. 
Увы, реализация Шрейсь в МЕС не поддерживает параметры с символьными 
именами. 


' Ашотаноп необходима для обращения к СОМ-объектам из языков программирова- 


ния, не поддерживающих указатели на функции, поскольку по стандарту СОМ интер- 
фейс — это массив указателей на функции (уаЫе). Согласно стандарту Аиютаноп 
интерфейс — это набор функций с целочисленными идентификаторами. Обращение 
к /2ёбрасЬ выполняется контролером неявно, внутри транслятора или интерпретато- 
ра. — Прим. перев. 

Целочисленные индексы методов и свойств необходимы по стандарту АшютаНоп. — 
Прим. перев. 
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Варианты программирования в АщШотайоп 


Допустим, вы собираетесь написать компонент АшотаНоп на С++. Прежде чем это 
сделать, нужно ответить на ряд вопросов. Каким должен быть компонент — внут- 
ренним или внешним? Какой нужен пользовательский интерфейс? И нужен ли 
вообще? Разрешать ли запускать ЕХЕ-компонент как автономное приложение? Если 
компонент будет в ЕХЕ-модуле, то в каком именно: с МП]- или с $П!-интерфей- 
сом? Допустимо ли прямое завершение программы компонента пользователем? 

Если сервер разместить в РЦ, связь на основе СОМ окажется эффективнее, чем 
в случае ЕХЕ-компонента, поскольку не нужен никакой маршалинг. Однако в ОШ, 
возможности пользовательского интерфейса крайне ограниченны. Практически 
единственное, что доступно, — это модальное диалоговое окно. Если же вам ну- 
жен компонент, у которого есть собственное дочернее окно, понадобится АспуеХ- 
элемент, а если к тому же вам требуется окно-рамка, придется создать внешний 
компонент. Как и обычная 32-разрядная О, О.-библиотека АиютаНоп проеци- 
руется на адресное пространство клиентского процесса. Если два клиента обра- 
щаются к одной РЦ, УЛюаоу$ загружает и динамически подключает ее дважды. 
Оба клиента при этом и не «подозревают», что работают с одним и тем же ком- 
понентом. 

В случае ЕХЕ-компонента надо быть очень внимательным и различать поня- 
тия «программа компонента» и «объект компонента». Когда клиент вызывает /С4я55- 
Еадюту::Стещетяапсе для создания объекта, тот создается фабрикой класса в ком- 
поненте, но при этом СОМ может как запускать, так и не запускать программу 
компонента. 

Вот некоторые из возможных сценариев. 


Ш Создаваемый СОМ класс компонента запрограммирован так, что для 
создания нового объекта требуется запуск нового процесса. В этом случае 
СОМ запускает новый экземпляр в ответ на второй и все последующие вызо- 
вы Стешетяапсе, каждый из которых возвращает указатель на ШёресЬ. 

Ш Особый вариант предыдущего сценария, характерный для МЕС-прило- 
жений. Класс компонента — это МЕС-класс документа в $01-приложении. 
Всякий раз, когда клиент вызывает СтещетяЯатсе, запускается новый экземп- 
ляр приложения компонента— с новыми объектами «документ», «вид» и основ- 
ным окном-рамкой $101. 

Ш Класс компонента допускает создание нескольких объектов в одном 
процессе. Всякий раз, когда контроллер вызывает Стешетяапсе, создается 
новый объект компонента. Но при этом запущена только одна копия процес- 
са компонента. 

Ш Особый вариант предыдущего сценария, характерный для приложений 
МЕС. Класс компонента — МЕС-класс документа в МО[-приложении. Выполня- 
ется одна копия компонентного приложения с одним основным окном-рам- 
кой МПИ. Всякий раз, когда клиент вызывает Стещеияаисе, создаются новые 
объекты «документ» и «вид» вместе с новым дочерним окном-рамкой МПИ. 


И еще один, более интересный случай: ЕХЕ-компонент уже выполняется, ко- 
гда клиент решает обратиться к существующему объекту. Это как раз относится к 
Ехсе!. Когда клиенту потребуется доступ к единственному объекту-приложению 
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Ехсе|, оно может быть в свернутом виде на рабочем столе. Тогда контроллер вы- 
зывает СОМ-функцию СеАсйоеОБест, которая возвращает указатель на интерфейс 
уже существующего объекта. Если вызов неудачен, контроллер может создать новый 
объект, вызвав СоСтешетяатсе. 

При уничтожении объекта компонента действуют обычные правила СОМ. 
У объектов АшюотаНоп есть счетчики ссылок, и эти объекты самоуничтожаются, 
когда контроллер вызывает Кееазе, а значение счетчика равно 0. В случае МП!- 
компонента, если объект АиютаНоп — МЕС-документ, удаление последнего вы- 
зывает закрытие соответствующего дочернего МО]-окна. В случае $01-компонен- 
та удаление документа приводит к завершению процесса компонента. Клиент сам 
отвечает за вызов Ке/еазе для каждого интерфейса ДёрецсЬ перед завершением 
работы. Если клиент, работавший с ЕХЕ-компонентом, завершился, не освободив 
интерфейсы, вмешивается СОМ и закрывает процесс компонента. Но лучше не 
полагайтесь на СОМ, а позаботьтесь сами, чтобы ваш контроллер выполнил кор- 
ректную очистку! 

В общем случае клиентское приложение зачастую получает несколько указа- 
телей на интерфейсы одного объекта. Вспомним пример с космическим кораб- 
лем из главы 22, где у класса в модели СОМ-компонента были указатели на (Моноп 
и /Убиа. Но при использовании АшотаНоп у приложения обычно по одному 
указателю (26рейср) на объект. Как всегда при программировании на основе СОМ, 
надо позаботиться об освобождении всех указателей на интерфейсы. В Ехсе!, на- 
пример, многие свойства возвращают указатель на /ШОёреисЬ для новых или суще- 
ствующих объектов. Если вы забудете освободить указатель на интерфейс внут- 
реннего СОМ-объекта, отладочная версия библиотеки МЕС сообщит об утечке 
памяти при завершении клиентской программы. 


МЕС-реализация /О/5расв 


В программе компонента интерфейс ёбрейсь можно реализовать несколькими 
способами. Обычно эти реализации возлагают основную работу на РИМ, поддержки 
СОМ в УЛп4оу\$, вызывая СОМ-функцию СтешеяРрейсь или передавая вызов 
тгоке интерфейсу Гуретую, который использует библиотеку типов (гуре ИБгагу) 
компонента. Последняя представляет собой таблицу, адрес которой хранится в 
реестре и которая позволяет клиенту запрашивать у компонента символьные имена 
объектов, методов и свойств. Например, клиент может иметь браузер библиотеки 
типов, позволяющий исследовать возможности компонента. 

Библиотека МЕС поддерживает библиотеки типов, но не применяет их в сво- 
ей реализации Шёрейсь, основанной на карте диспетчеризации (@райсв тар). 
МЕС-программы не вызывают Стеше$ ЮО рейсь и не используют библиотеку ти- 
пов для Пбресь::Сейр5О\атез, а значит, МЕС не годится для создания много- 
язычных компонентов АшотаНоп, которые одновременно поддерживают, скажем, 
английские и немецкие имена свойств и методов. (СтетеяярёресьЬ тоже не под- 
держивает многоязычные компоненты.) 

Позднее вы узнаете, как клиент может применять библиотеку типов и как МЕС 
МЕС-мастера создают такие библиотеки и работают с ними. Если у вашего ком- 
понента есть библиотека типов, клиент может просматривать ее независимо от 
вида реализации Оёреср. 
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Компонент Ашотаноп на базе МЕС 


Посмотрим, что происходит в компоненте Аотайоп (в данном случае это упро- 
щенная версия программы-будильника Ех23с, которую нам еще предстоит обсу- 
дить). Реализация ДёресВ в библиотеке МЕС включена в базовый класс ССта- 
Татвер, так что макросы /\УТЕКЕАСЕ. МАР вам не понадобятся. Класс компонента 
АшотаНоп, например СС/осА, объявляется как производный от ССтаТатвей, а СРР- 
файл этого класса содержит макросы О/5РАТСН МАР: 


ВЕСТМ_ОТЗРАТСН_МАР(СС1оск, ССмаТагдет) 
ОТЗР_РВОРЕВТУ(СС1оск, “Т1те”, м_{1те, УТ_ОАТЕ) 
ОТЗР_РВОРЕВТУ_РАВАМ(СС1оск, “Е1диге”, ветЕ1диге, 

ЗетЕ19иге, \УТ_\МАНТАМТ, УТ$_Т2) 
ОТЗР_РИМСТТОМ(СС1оск, “Веггезим1т”, Веггезп, УТ_ЕМРТУ, УТ$_М№ МЕ) 
ОТЗР_РИМСТТОМ( СС1оск, “ЗпоммМап", Эпоммап, УТ_ВООЕ, УТЗ_1Т2) 

ЕМО_ОТЗРАТСН_МАР() 


Похоже на карту сообщений МЕС, да? Заголовочный файл класса ССосё содер- 
жит связанный с макросом код: 


риб11с: 
ВАТЕ м_11ме; 
атх_тз9 \УАВТАМТ бееЕ1диге(зПоге п); 
атх_тз9 №0149 ЗеЕ1диге($Погт п, сопзф УААТАМТ& уа№ ем); 
аГх_тз9 уо19 ВеЁгезп(); 
атх_т$9 ВООЕ ЭПоми1п(зПоге п); 
ОЕСТАВЕ_ОТЗРАТСН_МАР( ) 


Что все это значит? А то, что у класса ССюсЁ следующие свойства и методы. 


Имя Тип Описание 
Типе Свойство — Прямо связано с переменной-членом т_Ите этого класса. 
Евите Свойство — Индексируемое свойство, доступное через функции-члены 


СейЯрите и 5ейвите; первый параметр — индекс, второй (для 
5ерите) — строка. (В строках хранятся цифры «ХПИ», «ШЬ, «У 
и «[Х», отображаемые на циферблате часов.) 


Кетезр\Ут Метод Связан с функцией-членом Ке/гезр; у него нет ни параметров, 
ни возвращаемого значения. 


5рош" т Метод Связан с функцией-членом 5роиУт; параметр — типа Вог 
ицебег, а возвращается булево значение. 


Как связаны карта диспетчеризации МЕС, ШёбресЬ и функция-член тоойе? 
Макросы карты диспетчеризации генерируют статические структуры данных, 
считываемые МЕС-реализацией /тооке. Контроллер получает указатель на /Оёресь 
для ССосЕ (связь осуществляется через базовый класс ССтАТатрер) и вызывает 
тооке, передавая ей в качестве параметров массив указателей. МЕС-реализация 
1тоове, упрятанная где-то в ССтаТатве, использует карту диспетчеризации СС/юсЁ 
для расшифровки переданных ей указателей и либо вызывает одну из функций- 
членов, либо обращается к т_Ите напрямую. 

Когда мы дойдем до примеров, вы увидите, что АЯА С!а$5 УЛхага способен сге- 
нерировать класс компонента АиюотанНоп и помочь построить карты диспетче- 
ризации. 
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Клиент АШотаноп на базе МЕС 


Теперь перейдем к клиентской стороне Ашотаногп. Как клиент АиютаНоп, создан- 
ный на базе МЕС, вызывает /о#е? Для этого МЕС-библиотека предоставляет класс 
соеррейсьОттиет. У него есть переменная-член и рОбрасЬ, в которой хранит- 
ся указатель на П2ёрейср соответствующего компонента. Чтобы оградить вас от 
сложной схемы передачи параметров в функцию токе, предусмотрено несколь- 
ко функций-членов класса СОеБёрейсЬОтет, в том числе моовеНерег, бейторегу 
и зе Ргорету. Каждая из них вызывает игоке через указатель на Дёреиср, связан- 
ный с компонентом и хранящийся в объекте СОеррейсьО тег. 

Допустим, в программе-клиенте есть класс ССюсеОтиет, производный от СОе)&- 
рейсьОтет и управляющий объектом ССоск в компоненте АшотаНоп. Функции, 
считывающие и записывающие свойство Типе, выглядят так: 


БАТЕ СС1оскОг1уег: : бе{Т1те() 

{ 
БАТЕ гези1{; 
бетРгорегту(1, УТ БАТЕ, (\014*)&гези1т); 
гефигп гези1\*; 


у01а СС1оскОг1уег: : Зе{Т1те(ОАТЕ ргор\а1) 
{ 

Зе{Ргорегту(1, УТ_ОАТЕ, ргор\а1); 
} 


Аналогичные функции для индексируемого свойства Рите: 


\УАВТАМТ СС1оскОг1уег: : бе{Е1диге( пог 1) 
{ 
\УАВТАМТ гези1*; 
эфаф1с. ВУТЕ рагмз[] = \Т$_12; 
Тпуокене1рег(2, ОТЗРАТСН_РВОРЕВТУСЕТ, УТ_МУАНТАМТ, 
(№014*)&гези11, рагтз, 1); 
гефигп гези1\*; 
} 
у014 СС1оскОг1уег: : ЗеЕЕ1диге (зпоге 1, сопзф УАВТАМТ& ргор\а1) 
{ 
Зфа{1с ВУТЕ рагт$[] = \Т$_12 \УТ$_\АВТАМТ; 
ТпуокеНе1рег(2, ОТЗРАТСН_РАОРЕВТУРИТ, УТ_ЕМРТУ, МИ 
рагмз, 1, &ргор\а1); 


И, наконец, функции для доступа к методам компонента: 


\019 СС1оскОг1уег: : ВеРгезви1т() 
{ 

Тпуокене1рег(3, ОТЗРАТСН_МЕТНОО, УТ_ЕМРТУ, МЕ, МАЕ); 
} 


ВООЕ СС1оскОглуег: : ЗпомМа п (зпоге 1) 
{ 
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ВООЕ гези1т; 

Зфаф1с ВУТЕ рагмз[] = УТ$_Т2; 

ТпуокеНе1рег(4, ОТЗРАТСН_МЕТНОО, \УТ_ВООЕ, (\014*)&гези1+, рагтз, 1); 
гефтигп гези1т; 


Параметры функции задают свойство или метод, его параметры и возвращае- 
мое им значение. Чуть позже вы подробнее познакомитесь с параметрами функ- 
ции диспетчеризации, а пока обратите особое внимание на первый параметр 
функций иоовеНерег, СеРгорегу и $е!Ргоретйу. Это уникальный целочисленный 
индекс — диспетчерский идентификатор (@зраись ТО, О1$РП) свойства или 
метода. В приведенном примере эти идентификаторы можно задать при компи- 
ляции, так как компонент заранее известен. Если же вы используете сервер Ашо- 
таНоп с картой диспетчеризации, идентификаторы (индексы) определяются по 
порядку элементов в таблице, начиная с 1. Неизвестные диспетчерские иденти- 
фикаторы компонента можно определить по символьным именам свойств или 
методов, вызвав функцию-член ЮбрасрВ::Сейр$ОрУатез. 

Следующий рисунок иллюстрирует взаимодействие клиента (контроллера) и 
компонента. Сплошными линиями показаны реальные связи, осуществляемые через 
базовые классы МЕС и функции /тооке, а пунктирными — логические связи меж- 
ду элементами классов клиента и компонента. 


Контроллер АШотаНоп Компонент Ащжотайоп 


СО/еб/зрасйОпиег 


сстатагое 
‚ беРторепу о 

_Зеторейу — 
_ [пуокеНафег 


Юзрасй:пмоке 


_ Сббекбеи 
рта диспетчеризации 


_ ССоскбот! — 
бете ----|--__ о 
бете ----| 
беноше -ф-- 
Зеише ---- 
ВейезвИт --- 
ЭпоиМт --- 


У большинства компонентов АшотаНоп есть файл двоичной библиотеки ти- 
пов с расширением ТГВ. Ааа С!а5$ УЛ2ага может использовать эту библиотеку типов 
для автоматической генерации класса производного от СОербресЬО тет. (До- 
статочно в меню Рго]ес! выбрать АЗА С1!а$$ и в отрывшемся окне — МЕС С1а55 Его 
Туре.) Такой сгенерированный класс контроллера содержит функции-члены для 
всех методов и свойств класса с жестко заданными О!$Р№Ш-идентификаторами. 
Иногда код, сгенерированный АЧа С!а55 УЛгтага, требует ручного вмешательства, 
но лучше так, чем самому писать все функции. 
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После генерации класса контроллера объект этого класса встраивается в класс 
«вид» (или какой-либо иной класс) клиентского приложения примерно так: 


ССТоскОг1уег м_с1оск 

Затем делается запрос к СОМ для создания объекта компонента часов: 
т_с1оск. Сгеафе01зратсй ( "Ех23с. оситепт”) 

Теперь мы готовы к вызовам функций компонента: 


т_сТоск. зетТ1те (СО1ератеТ1те: : бетСиггетТ1те()): 
т_с1оск. Веггези\1т(); 


Когда объект 72 сюсЁ покидает область видимости, его деструктор освобожда- 
ет указатель на /Оёрейср. 


Использование директивы 
компиляции #1трой клиентом Ашщотайоп 


Теперь появился новый способ написания клиентских программ на основе Аио- 
таНоп. Вместо вызова АЯ С!а$$ УЛгага для генерации класса, производного от 
сОерресьр тет, можно заставить компилятор создать файлы заголовков и ре- 
ализации прямо из библиотеки типов. В нашем примере клиентская программа 
содержит инструкцию: 


Н1трогЕ”. .\Ех23с\дерид\Ех23с. +16” гепате_патезрасе( "С1оскОг1\") из1п4 патезрасе 
СЛоскОг1м; 


Компилятор в этом случае создаст (и затем обработает) в подкаталоге проек- 
та Оериз или Ве!еазе два файла: Ех23с.ИВ и Ех23с.4. ТИН-файл содержит объявле- 
ние управляющего класса /Ёх23с плюс объявление 5$77а71-указателя (таг ройцег): 


_С0М_$МААТРТВ_ТУРЕБЕЕ(ТЕх23с, __ии1901(ТО1зратсп)); 


Макрос _СОМ_5МАКТРТК_ТУРЕРЕЕ генерирует тип /Ех23сРи', инкапсулирующий 
указатель на /0ёресЬ компонента. ТИ-файл содержит встраиваемую (шйИпе) ре- 
ализацию функций-членов, несколько примеров которых приведены ниже: 


1111пе ННЕЗОЕТ ТЕх23с: :Веггезим1т () { 

гетигп _сот_91зратсп_тетпоа(111$, 0х4, ОТЗРАТСН_МЕТНОО, 
\Т_ЕМРТУ, М, МЕ); 

} 

1111пе ОАТЕ ТЕх23с: : @е{Т1те () { 
БАТЕ _гези1*; 
_сот_91зратсп_ргордее(+11$, 0х1, УТ ОБАТЕ, (\0149*)&_гези1т); 
гефигп _гези1т; 

} 

1п1]1пе уо1д ТЕх23с: :Риф{Т1ме ( БАТЕ _\а1 ) { 
_сот_91зрафсй_ргорри*(1+11$, 0х1, \УТ_ОАТЕ, _уа1); 

} 


Обратите внимание на сходство этих функций с функциями СОеБбресЬО тег, 
которые мы уже рассматривали. Функции _сот_а&ресь тефоа, сот_@ресь рто- 
рае! и _сот_@5ресь_рторри находятся в библиотеке периода выполнения. 
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В клиентской программе переменная-член объекта этап-указателя встраива- 
ется в класс «вид» (или иной класс) приблизительно так: 


ТЕх2ЗсРЕг м_с10ск; 


затем создается объект компонента при помощи оператора: 


п_с1оск. СгеатеТпзТапсе (__ии1аот(Воситепт)); 


Теперь для вызова функций-членов, определенных в ТИ-файле, можно приме- 
нить перегруженный оператор -> класса /Ех23сРи: 


т_с10ск->Ри*Т1ме(С01ебатеТ1те: :ве{СиггептТ1те()); 
тм_с1оск->ВеРгезви1т(); 


Когда объект зтаг-указателя 7 _сосЁ покидает область видимости, его деструк- 
тор вызывает СОМ-функцию Кееазе. 

Директива #ипрогЕ — будущее СОМ-программирования. С каждой новой вер- 
сией У15иа1 С++ возможности СОМ «переползают» в компилятор, впрочем, это же 
верно по отношению к архитектуре «документ-вид». 


Тип данных УААГАМТ 


Несомненно, вы обратили внимание на тип УАЮМАМТ в коде клиента и компонен- 
та из предыдущего примера. УАЮАМТ — это универсальный тип данных, исполь- 
зуемый ЮёресЬ:тооЁе для пересылки параметров и возвращаемых значений. Он 
очень хорошо подходит для обмена данными с УВА. Взгляните на упрощенную 
версию определения типа УАМАМТ в заголовочных файлах У/п9о\: 


ЗТгисфт тад\АВТАМТ { 


\/АВТУРЕ \{; // код типа беззнаковое короткое целое 
МОВО мВезегуед1, мВезегуеЧ2, мВезегуедЗ; 


иптоп { 
ПОГ 1\а1; // УТ_12 короткое целое 
1019 1\а1; // УТ_Т4 длинное целое 
Поат Е] 1\а1; // УТ_В4 4-байтовое с плавающей запятой 
90и61е 961\а1; // УТ_В8 8-байтовое с плавающей запятой 
БАТЕ дате; // УТ_ОАТЕ хранится как число 
// типа доцб1е в формате “дата. время” 
С МЕСУ // УТ_С\У 64-разрядное целое 
ВУТА о${г\а1; // УТ_ВУТН 
Пупкпомп* рипК\а1: // УТ_УМКмомм 
ТО1зрафсй»* = р91$р\а1; //.УТ_ОТЗРАТСН 
ЗПог{* р1\а1; Д/ УТ ВУВЕЕ, ча С То 
10пд* р1\а1; // УТ ВУВЕЕ : УТ_1Т4 
оа** р+11\а1; // МТ_ВУНЕЕ : УТ_В4 
9ои61е* р961\а1; // УТ_ВУНЕЕ !: УТ_В8 
ОАТЕ* рдате; // УТ_ВУВЕЕ ; УТ_ОАТЕ 
(Ух рус; // МТ_ВУВЕЕР ': УТ_СУ 
ВУТН* розфг\ат; // \Т_ВУВЕЕ : УТ_ВЗТВ 
} 


}; 


Туреде{Р зтгист Тад\АВТАМТ \УАВТАМТ; 
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Как видите, ИАЮАМТ — это структура языка С, содержащая код типа #1, несколько 
байтов-заполнителей и большое обзединение (ипюп) уже известных вам типов. 
Если значение #1 равно, скажем, УТ 12, значение УАМАМТ следует считывать из поля 
гиа1, содержащего двухбайтовое целое. Если же 1 равно УТ_В8, используется поле 
АМ, где хранится 8-байтовое число. 

Объект УАЮАМТ может содержать как сами данные, так и указатель на них. Если 
в поле # установлен бит УТ _ВУКЕЕ, для доступа к данным следует применить ука- 
затели риа РИМ и т.д. УАМАМТ может содержать указатель на иёпоши или 
Р5раср. Это значит, что в вызове АиютаНноп можно передать целый СОМ-объект, 
но если вы хотите, чтобы этот объект обрабатывался в УВА, класс объекта дол- 
жен поддерживать интерфейс Обраср. 

Строки — особый случай. Тип ВУТЮ — еще один способ представления строк 
символов. Переменная этого типа является указателем на массив символов, закан- 
чивающийся нулевым символом'. Количество символов в массиве хранится не- 
посредственно перед его началом. Так что переменная В5ТК может содержать 
неотображаемые (бинарные) символы, в том числе нули. Если имеется объект 
УАМАМТ с & = УТ_ВЗТК, содержимое памяти выглядит так: 


Объект ИАВИАМТ Выделенная память 


_И=УТ В5ТВ ‚Число символов (целое) 


_ Символы у строки 


зи\Иа (4-байтовый указатель) [ 


Завершающий нулевой байт 


Так как строка заканчивается нулевым символом, то с 65"Иа/ можно работать, 
как с обычным указателем на сваи, но при этом следует быть исключительно вни- 
мательным к освобождению памяти, Этот указатель нельзя просто удалить, посколь- 
ку выделенная область памяти начинается с числа символов. Для размещения и 
удаления объектов ВУТК в ОТЕ ри функции а и НУ 


ль бузАпосбртив — еще одна сом- "ани, параметром которой 
служит строка 2-байтовых символов. Это означает, что все В5ТА-строки 
содержат 2-байтовые символы, даже если вы не определили макрос _0М!- 


СОБЕ. Будьте внимательны?. 
И п п сми 


Для работы с УАЮМАМТ в УЛпао\5 есть несколько полезных функций, в том числе 
приведенные в таблице. Если УАЮМАМТ содержит В$ТК, эти функции гарантируют 
правильное выделение и освобождение памяти. Функции ИлтапИий и Уанапеаг 


' То есть с кодом, равным 0. — Прим. перев. 


* Так как все ВУТЕ-строки содержат символы ИМСОРЕ, работать с такими строками, 
как с указателями на сБа’, нельзя вопреки утверждению автора. Из этого же следует, 
что в конце строки находятся два нулевых байта, а не один, как показано на рисун- 
ке. — Прим. перев. 
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присваивают #4 значение УТ_ЕМРТУ. Все функции для УАМАМТ — глобальные и в 
качестве параметра принимают значение типа УАЮАМТ*. 


ИИА 


Функция Описание 

УлпапИпй Инициализирует УАЩАМТ. 

Уапапеатг Очищает УАВТАМТ. 

УапаисСору Очищает память, связанную с УАВТАМТ-получателем, и копирует 


в него УАВТАМТ-источник. 


УапатСорута Очищает память, связанную с УАВ!АМТ-получателем, и производит 
преобразования, чтобы скопировать УАВТАМТ без флага УТ_ВУКЕЕ 


УлпатсратвеТуре Изменяет тип УАВТАМТ-значения. 


Класс СОеУуамйат 


Есть смысл написать класс-оболочку С++ структуры УАЮМАМТ. Конструктор класса 
вызывал бы ИяйапИий, а деструктор — Уипаюсеаг. У такого класса можно преду- 
смотреть конструктор для каждого стандартного типа, а также конструктор ко- 
пии и оператор присваивания, которые вызывали бы УяйатСору. При передаче 
управления за пределы видимости блока, в котором объявлен объект этого класса, 
происходил бы вызов деструктора, и память освобождалась бы автоматически. 
Именно такой класс уже написан разработчиками МЕС. Он отлично работает 
и с клиентами и компонентами АщотаНоп. Вот упрощенное объявление класса: 


с1азз С01е\аглапЕ : риб11с Тад\АВТАМТ 
{ 
// Конструкторы 
руб11с: 
С01е\аг1апт(); 


СО1е\аг1ап(сопзе УААТАМТ& уагЭгс); 
СОТе\аг1ап(сопзЕ С01е\аглаптЕ& уаг$гс); 


СО1е\аг1ап(ЕРСТЭТВ 1р$75гс); 
С01е\Маглапт(С51г1п9& з%гЗгс); 


<> 
> 


е\аг1ап*(ВУТЕ п5гс); 
СО1е\аглап{ (пог пбгс, МАВТУРЕ \МЕ$гс = УТ_1Т2); 
С01е\аг1ап{ (101 п5гс, \МАВТУРЕ мЕ5гс = \Т_14); 


С01е\аглат (10а Е11$гс); 

СО1е\аглап(9ои61е 9615гс); 

С01е\аг1ап*(сопз{ С01ебатеТ1те& датеЗгс); 
// Деструктор 


-СОТе\агтапт(); // освобождает ВЗТН 
// Операции 
руб11с: 

\019 С1еаг(); // освобождает ВУТВ 


\УАВТАМТ Оетасп(); —// подробности позже 
\019 СпапдеТуре(\АВТУРЕ уагфуре, ЕРУАВТАМТ р5сг = МЕ); 
}; 
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Кроме того, в классах САгорйе и СритрСотех! предусмотрены операции срав- 
нения, присваивания, приведения типов и дружественные операции вставки/из- 
влечения. Полное описание этого МЕС-класса СОеУятатй см. в интерактивной 
документации. 

А теперь посмотрим, как класс СОеУямат! помогает писать функцию компо- 
нента Сей виге, ссылку на которую вы видели в приведенной выше карте диспет- 
черизации. Пусть компонент хранит строки для четырех цифр в переменной-члене: 


рг1\уате: 
С5г1па м_э+гР1диге[4]; 


Вот что надо сделать при прямом использовании структуры УАЮАМТ: 


\УАВТАМТ СС1оск: : беёЕ1диге(зпог* п) 
{ 
УАВТАМТ уаВези1т: 
: : УагтапЕТп1* (&уаВези1*); 
уаНези1 т.м = \Т_ВУТВ; 
// С$1г1п9::А1106$у351г1п9 создает ВЗТВ 
уаАези1т. о$4г\/а] = м_з+гЕ1диге[п].А110с5уз54г1п9(); 
гефигп уаВези1т: // Копируем уаВези14, не копируя ВУТВ 
// ВЗТА надо будет освободить позднее 


А вот то же самое, но с использованием СО/еУайпапЕ 


\/ААТАМТ СС1оск: : беёЕ1диге(зпоге п) 
{ 
гефигп С01е\аг1ап{ (т_згЕ1диге[п]).Бефасп(); 


Вызов функции СО/еУяпати::РеасЬ здесь совершенно необходим. Функция 
сейвите создает временный объект, содержащий указатель на ВУТК. Этот объект 
побитно копируется в возвращаемое значение. Если вы не вызовете еаср, деструк- 
тор СОеУятаи! освободит память, занимаемую ВУТК, и вызывающий процесс по- 
лучит УАК/АМТ с указателем, ссылающимся «в никуда», точнее, просто на какой-то 
«мусор». 

УАМАМТ-параметры функций компонента, вызываемых через Рёреср, объяв- 
лены как соп$1 УАМАМТ®.. Внутри функции тип указателя на УАЮАМТ всегда можно 
преобразовать в указатель на СО/еУятати. Вот пример функции $еИйвите: 


у014 ССТоск$егу: :Зе{Р1диге($ВогЕ п, сопз+ \УАВТАМТ& уа№ем) 
{ 
СО1е\аг1апт уаТетр; 
уаТетр. СпапдеТуре(МТ_ВУТА, (С01е\аглапе*) &ма№ ем): 
тм_$ЕгР1диге[п] = уаТетр. озтг\а1; 
} 


И 
Примечание Помните, что все ВУТК-строки содержат 2-байтовые символы. 


В классе С5 ия есть конструктор и оператор присваивания для типа 
1РСУЗТК (указатель на 2-байтовые символы). Таким образом, строка 
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т_я"Нюиге будет содержать однобайтовые символы, хотя Ву"! и ука- 
зывает на массив 2-байтовых символов. 


У АЮАМТ-параметров функций клиента, вызываемых через Шёрась, тот же 
тип — с0п5: УАМШАМТ®.. Вы можете передавать в них как УАЮАМТ, так и объект 
соеиатате. Взгляните на такой вызов функции ССсЕ::$еИйвите: 


рС1оскОг1уег->5е1Р19иге(0, С01е\аг1апт(“ХТТ")); 


Примечание Вы вправе также задействовать для В5ТК и УАМАМТ стандартные, 
независимые от библиотеки МЕС классы _б5" фи _гапатЕ 1. Первый 
инкапсулирует тип В$ТК, второй — УАМАМТ. Оба класса корректно вы- 
деляют и освобождают память. Подробнее об этих классах см. докумен- 
тацию по \151а1 5таЧю „МЕТ. . 


Преобразования типов параметров 
и возвращаемых значений для Гпуоке 


Все параметры и возвращаемые значения Шёреср:/тооке обрабатываются в ней 
как данные типа УАМАМТ. Помните об этом! Реализация [поое в библиотеке МЕС 
способна сама выполнять преобразования между УАЮАМТ и любым переданным 
вами типом (если такое преобразование возможно), что обеспечивает определен- 
ную гибкость в объявлении типов параметров и возвращаемых значений. Допус- 
тим, контроллерная функция Се! вите возвращает тип В$ТК. Если компонент воз- 
вращает й или юпв, все в порядке: ОГЕ и библиотека МЕС преобразуют число в 
строку. А если компонент принимает параметр ив, тогда как контроллер пере- 
дает м И вновь никаких проблем. 


Примечание МЕС-клиент Ажотайоп задает ожидаемый тип возвращаемого 
значения как параметр УТ_ функций беРторету, $еРгорету и тоовеНерет 
класса СОерёбрась)тоет. МЕС-компонент Ашюотайоп указывает ожида- 
емые типы параметров как параметры У75$_ в макросах 25Р_РКОРЕКТУ 
и ОБР ЕОМСПОМ. 


В отличие от С++ в УВА нет строгого контроля типов. Переменные в УВА внут- 
ренне часто представляются как УАЮАМТ. Возьмем, например, значение в ячейке 
электронной таблицы Ехсе!. Пользователь может ввести в ячейку текстовую строку, 
целое значение, число с плавающей запятой или дату. УВА рассматривает данные 
в ячейке как УАК/АМТ и возвращает клиентам Аиютайоп объект именно этого типа. 
Если возвращаемое значение функции клиента объявлено как УАМАМТ, контроллер 
может проверить значение и и соответствующим образом обработать данные. 

В УВА применяется формат даты/времени, отличный от формата МЕС-класса 
СТите. Переменные типа ДАТЕ хранят и дату, и время как единое значение типа 
аоиЫе. Дробная часть представляет время (0,25 соответствует 6 часам утра), а це- 
лая — дату (число дней, прошедших с 30 декабря 1899 г.)'. Библиотека МЕС пре- 


' Отрицательные значения соответствуют датам до 30 декабря 1899 г. — Прим. перев. 
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доставляет класс СОерщеТите, облегчающий работу с датами. Дату вы можете 
сформировать так: 


Сотератет1те дафе(2001, 2, 11, 18, 0, 0); // 11 февраля 2001 г., 6 часов вечера 


В классе СОеУапат определен оператор присваивания для соершщеТите, а у 
СОершеТте есть функции-члены для выделения компонентов времени и даты. 
Вот как можно вывести показания времени: 


ТВАСЕ("1те = %9:%9:%а\п”, 
дате.бетНоиг(), дахе. веёМ1пие(), дате. бетесопа()); 


Если у вас есть переменная УАЮАМТ, содержащая значение типа ДАТЕ, то для 
преобразования даты в строку можно вызвать функцию СОе\атапт:СфапвеТуре: 


СО1е\аг1апт уаТ1тебафе = дате; 
С01еУаглапт уаТептр; 

уаТетр. СпапдеТуре(МТ_В$ТВ, &\атТ1тебате); 
(517119 з1г = маТетр. 6$%г\а1; 

ТВАСЕ( “дате = %3\п", з$1г); 


И последнее замечание о параметрах тоове: у функции, вызываемой через 
Шрейсь, могут быть необязательные (орНопа!) параметры. Если компонент объяв- 
ляет тип последних параметров (крайних справа) как УАМАМТ, то клиент не обя- 
зан передавать их. При таком вызове (без определения значения необязательно- 
го параметра) поле 11 объекта УАМАМТ на стороне компонента будет содержать 
УТ ЕВВОК. 


Примеры АшотаНоп 


В оставшейся части главы мы познакомимся с пятью примерами. Первые три — 
компоненты Ашюотайоп: ЕХЕ-компонент без пользовательского интерфейса, РИ.- 
компонент и ЕХЕ-компонент как $01-приложение, допускающее одновременный 
запуск нескольких копий. К каждой из этих программ приложена рабочая книга 
Мсгозой Ехсе!. Четвертый пример — это МЕС-клиент АшотаНоп, управляющий 
тремя вышеупомянутыми компонентами, а также приложением Ехсе! при помо- 
щи класса СОеррейсьОтеет. Последний пример — клиентская программа, в ко- 
торой вместо класса СОеррасьОтиет используется директива #йтпроп. 


Пример Ех2За: ЕХЕ-компонент 
без пользовательского интерфейса 


Ех23а — типичный пример использования Ацотаноп. Программа похожа на 
АшосИск — пример МП1-приложения с объектом-документом в качестве компо- 
нента АшотаНоп. (Пример в АшосЦскК легко найти в МЕС Бгагу Веегепсе, вы- 
полнив поиск по слову АщоСИК.) Пример Ех23а отличается от АшюсНск отсутствием 
пользовательского интерфейса. В Ех23а один класс, поддерживающий Ацютайоп, 
и в первой версии программы один процесс поддерживает создание нескольких 
объектов АиютанНоп. Во второй версии при создании клиентом АиютаНоп каж- 
дого нового объекта запускается новый процесс. 
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В Ех23а компонент, написанный на С++, реализует обработку финансовых 
транзакций. УВА-программистам доступно создание приложений с мощным поль- 
зовательским интерфейсом, которые полагаются на правила аудита, заложенные 
в логику компонента АшотаНоп. В коммерческом варианте такого компонента 
мы скорее всего использовали бы базу данных, но Ех23а проще. Здесь реализова- 
ны банковские счета с двумя методами Дерозй (положить на счет) и Уйрагаиеий 
(снять со счета), а также доступные только для чтения свойством Ваапсе (оста- 
ток на счете). Ясно, что метод Уйрагаше не должен создавать отрицательного ос- 
татка. Для управления компонентом можно задействовать Ехсе! (рис. 23-3). 


ЕЯ мкговой Енсе!- Ен2За. 


Рис. 23-3. Рабочая книга Ехсе,, управляющая компонентом Ех23а 


Итак, создадим программу Ех23а. 


1. Средствами МЕС АррНсайоп \/12аг4 создайте проект Ех23а. На странице 
АррИсаНоп Туре установите переключатель в положение Р1аюз Базед. Сбрось- 
те все флажки на страницах О5ег Ииегасе Ееабигез и Адуапсеа Ееагигез, кроме 
флажка АшотаНоп на странице Адуапсеа Ееагигез. В результате вы получите 
самое простое приложение, какое только умеет генерировать МЕС АррИсаНоп 
УЛгага. 

2. Уберите из проекта класс диалогового окна. В УЛп4о\з Ехр!огег (Провод- 
ник) или в командной строке удалите файлы Ех23аП1е.срр, Ех23аРе.1, ПеРго- 
хусрр и РзРгоху.В. Уберите эти файлы и из проекта, удалив их в окне боаНоп 
Ехр!огег. Отредактируйте файл Ех23а.срр: удалите оператор #тсшае, относя- 
щийся к классу диалогового окна, а также весь связанный с диалоговым окном 
код в иШияапсе. В Кезоигсе У1е\у ликвидируйте диалоговый ресурс ШРО_ЕХ2ЗА 
_БГОС. 

3. Добавьте код поддержки АшотаНоп. Благодаря установке флажка Ашо- 
таНоп в 5(ААЁх.В появилась строка: 


Н1ис1иде <аРха1зр. > 


Функция ий тяатсе содержит теперь код инициализации СОМ. Добавьте в 
нее (в файле Ех23а.срр) оператор гешги ТВОЕ: 


ВООЕ СЕх2ЗаАрр: : Тп1Тпзфапсе() 
{ 
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С\1пАрр: : Тп1Тизтфапсе( ): 
// Ти 1а112е ОЕ 116 гаг1ез 
1Е (!АРхО1е1п1*()) 
{ 
АГХМеззадеВох ( ТОР_О1Е_ТАМТТ_РАТЕЕВ); 
гефигп РАЕЗЕ 
} 
// Рагзе соттапа 11пе Гог аифома1оп ог гед/ипгед зи1+спез. 
ССоттапа1пеТпто статпто; 
РагзеСоттапа 1 пе (стаТпРо); 


// Арр маз 1аипспед м1Ей /Етбеда1па ог /Аитота1оп зматсв. 
// Вип арр аз аитота1оп зегуег. 
17 (стаТпРо. п_бВипЕтбедаеа !! стаТпто. м_ОВипАитотатеа) 
$ 
// Вед1зфег с1азз Гастог1ез у1а СоВед1зтегС1аз$063ес\() 
С01еТетр1атезегуег: :Вед1з+егА11(); 
гефигп ТВОЕ; 


// Арр маз 1аипснед м1В //пгедзегуег ог //пгедаз+ег зм1Асв 
// Ветоуе ептг1ез Ргом Те гед1зтгу. 

е15е 11 (стаТиРо.т_п5пе11Соттапа == 

ССоттапаЕ1пеТпто: :АррИпгед1зтег) 


{ 
С01е063] естРастогу: : /рдатеНед1$1гуА11 (ЕАЕЗЕ); 
АРХО1е/пгедузтегТурег1ь(_1114, _и\егМадог, _м\егМ1пог): 
гефигп РАГУЗЕ; 

} 


// Арр маз 1аипспед зфапаа1опе ог маи офпег зм14спез 
// (е.9. /Ведазтег ог /Ведзегуег). Црдате гедлз1гу епег1ез, 
// 11149119 Туре11ьгагу. 
е1е 
{ 
С01е06] естРастогу: : /рдафеАйед1${гуА11(): 
АТХО1еВед1+егТуреЕ1ь (АРхбе{ТпзтапсеНапа1е(), _+{119): 
11 (стаТпРо. т_пзпе11Сотмапа == 
ССоттапа11пеТпто: : АррВед1зтег) 
гефигп РАЁУЕ; 
} 
гефигп РАЕЗЕ 


ГЛАВА 23 Ащота{оп 517 
Е ЗРЕНИЕ Е УВоан  есоаотИИИаециий 


4. Средствами мастера АВА (1а5$ УЛтаг4 добавьте класс СВаиё: 


МЕС С135$ УИгагд - Еи2За 


У’екоте 10 {Пе МЕС С!а$$ УИгагЧ 


ТВ уигаг4 а445 а аз (Ва през гоп МРС о уошг ргодесЕ, ОрНопз тау сРапде ‘дерепдпд 
оп Ве Базе с1а5$ заесед. 


Обязательно установите переключатель в положение СгеаеаЫе Бу гуре Ш. 
5. С помощью мастера А94 С1а$5 УЛ1гага добавьте два метода и свойство. 
Откройте окно С1а5$ У1еу’, разверните узел библиотеки Ех23а и щелкните пра- 


вой кнопкой узел /Вапк. Вы увидите команды АЧа Метоа и Ааа Ргорецу; до- 
бавьте метод Уйрагашай 


|А49 Меов УйхагВ - Ех. 


Параметр 4Атоит! задает сумму, снимаемую со счета, а в возвращаемом 
значении сообщается фактически снятая сумма. Если вы попробуете снять со 
счета $100, на котором только $60, функция вернет значение 60. 


Добавьте аналогичный метод Реро$й, возвращающий значение типа 2014, а 
потом — свойство Вщапсе: 


18—2064 
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ГАЧЧ Ргорег 


\/екоте {0 {Пе АЗФ Ргорегбу МИгага 
ТРЕ уйгаг а445 а ргореку Ко уси ивегГасе, 


Мы могли бы напрямую обращаться к переменной-члену компонента, но 
тогда нам не удалось бы обеспечить доступ к нему в режиме только для чте- 
ния. Поэтому мы выбираем переключатель Се(/5е! теоа$ и превращаем функ- 
цию 5е1Вщапсе в ничего не делающую заглушку. 


6. Добавьте в класс СВанЁ открытую переменную-член ш_ЯВаапсе типа 
Ч4оиЫе. Поскольку мы выбрали для свойства Ва!апсе параметр Се!/5еЕ те Нод$, 
АЯ Ргорепу УЙтага не сгенерирует переменную-член. Переменную следует 
объявить в файле Вапк.В и инициализировать ее в конструкторе, расположен- 
ном в файле Вапк.срр, присвоив ей значение 0.0. 

7. Отредактируйте сгенерированные функции для методов и свойств. 
Добавьте выделенный код: 


ООУВЕЕ СВапк: : ИзЕП@гама1 (БОУВЕЕ дАтоип*) 
{ 
АРХ_МАМАСЕ_ЗТАТЕ( АРхбетАррМоди1е$та+е()); 
1Е (ЧАтоип{ < 0.0) { 
гефигп 0.0; 
} 
11 (9АтоипЕ <= м_ЧВа1апсе) { 
п_ЧВа1апсе -= ЧАтоипт; 
гефигп ЧАтоипт; 
} 
90и61е ЧТетр 
п_ЧВа1апсе = 
гефигп 9Тетр; 


= т_ОВа1апсе; 
0.0; 


} 
\014 СВапк: :Вероз11 (ВОУВЕЕ ЧАтоип*) 
{ 
АРХ_МАМАСЕ_ЭТАТЕ( АРхбетАррМоди1е5ате()); 
11 (ЧАтоипе < 0.0) { 
гефигп; 
} 
п_ОВа1апсе += ФАтоип*; 
} 
ООУВЕЕ СВапк: : бетВа1апсе(\019) 


10. 


11. 
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АРХ_МАМАСЕ_ЭТАТЕ( АРхбетАррмоди1езтате()): 
гефигп м_9Ва1апсе; 
} 
\014 СВапк: : Зе{Ва1апсе(БОУВЕЕ пем\а1) 
{ 
АРХ_МАМАСЕ_ЭТАТЕ( АРхбетАррМочи1е$ ате()): 
ТВАСЕ(“Зоггу, Бауе, Т сап’+ 40 +пат!\п”): 
} 


Соберите программу Ех23а и запустите ее один раз на исполнение, чтобы за- 
регистрировать компонент. 


Подготовьте пять макросов Ехсе] в новом файле Ех23а.х15. Вот их текст: 


01т Вапк Аз 06]ес+ 
биб [оадВапк() 

Зее Вапк = Сгеате06]ест(”Ех2За.Вапк") 
Епа $и6 


Зиб Цп1оа@Вапк() 
бет Вапк = №\111п9 
Епа $и6 


сиб 0о0еро$1*() 

Вапде (“04”). Зе1ест 

Вапк. бероз1{ (Аст1\еСе11. Уа1ие) 
Епа 5и6 


сиб Оом1{Идгама1 () 
Вапде("Е4”). Зе1ес+ 
01т Амте 
АтЕ = Вапк. М1 П9гама1 (АсЕ1\еСе11.. Уа1ие) 
Вапде("Е5"). $е1есе 
АСТ1\еСе11.\/а1ие = Амте 
Епд $и6 


биб боТпаи1гу() 
01т Амте 
АтЕ = Вапк. Ва1апсе() 
Вапде( "64". Зе1ес* 
АСЕ1уеСе11.\а1ие = Ат 
Епа $и6 


Подготовьте рабочую тетрадь Ехсе! (см. рис. 23-3). Закрепите макросы за 
кнопками (воспользуйтесь правой кнопкой и контекстным меню). 
Протестируйте банковский компонент Ех23а. Щелкните кнопку Гоаа Вапк 
Ргозгат, введите вносимую на счет сумму в ячейку 04 и щелкните кнопку 
Рерозй. Щелкните кнопку Ва!апсе шаийу — в ячейке С4 должно появиться 
значение остатка. Введите в ячейку Е5 снимаемую со счета сумму и щелкните 
кнопку \/В@гаууа!. Чтобы узнать текущий остаток на счете, опять щелкните 
кнопку Ва!апсе шаицу. 
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А А ааа 
Примечание Иногда придется щелкать кнопки два раза подряд. Первый щел- 
чок возвращает фокус на таблицу, и только второй запускает макрос. 


Курсор в виде песочных часов подскажет, что макрос исполняется. 
мк 


Что происходит в этой программе? Рассмотрим функцию СЁх23аАрр:1итяатсе. 
Если ее запустить прямо из УЛп4о\5, она обновляет реестр, сообщает об этом в 
информационном окне и завершается. Функция СОеОБес!Еасюту;:ПрашеКез Ай 
выполняет поиск глобальных объектов — фабрик классов; макрос /МРГЕМЕМТ _ОЕ- 
СКЕАТЕ из класса СВапё как раз и определяет такой объект. (Строка, содержащая 
1МРЕЕМЕМТ_ОТЕСКЕАТЕ_ЕТАС$, сгенерирована потому, что мы выбрали для СВапЁ 
параметр СгемеаЫе Бу гуре ТО.) В реестр добавляются уникальный идентифика- 
тор класса и программный идентификатор Ех23За.ВАМК. 

Когда Ехсе! вызывает СтежшеОвБуеср, СОМ загружает программу Ех23а, содержа- 
щую глобальную фабрику для объектов СВаий; затем СОМ вызывает функцию 
Стешетяатсе объекта-фабрики для создания объекта СВаий и возвращает указа- 
тель на /215ресЬ. Если пропустить несущественные подробности (и показанные 
ранее функции для методов и свойств), то сгенерированный мастером Ааа С!аз$ 
УЛгтага класс СВапйЁ выглядит так: 


#ргадта опсе 

// СВапк соттапа Тагдет 

с1аз$ СВапк : риб11с ССмаТагдет 

{ 
ОВЕСТАВЕ_ОУМСВЕАТЕ( СВапк) 

риу611с: 
СВапк(); 
У1гфиа1 “СВапк(): 
\1гфиа1 уо19 ОпР1па1Ве1еазе(); 
РОУВЕЕ п_Ч9Ва1апсе; 

рготестед: 
РЕСТАВЕ_МЕЗЗАСЕ_МАР() 
РЕСТАВЕ_ОЕЕСВЕАТЕ( СВапк) 
ОВЕСТАВЕ_ОТЗРАТСН_МАР() 
ОВЕСТАВЕ_ТМТЕВЕАСЕ_МАР( ) 
ООУВЕЕ М1{Пагама1 (БОУВЕЕ ЧАтоип*): 


015р19Ва1апсе = 3, 91$р190ероз1{ = 21, 91$р19\1{П9гама1 = 11 
}: 
\014 Оеро$1+(ВОЦВЕЕ ЧАтоип*); 
БОПВЕЕ @е{Ва1апсе(\о1а); 
\014 ЗетВа]1апсе(ВоуВЕЕ пем\а1); 


А вот код, автоматически сгенерированный АЗ С1а$5 УЛгагА в файле БапК.срр: 


// Вапк.срр : 1тр1етептаф1оп +Е11е 
// 

{пс1иае “зтдафх. п” 

#1 ис1иае “Ех2За. п” 

#1пс1иде “Вапк. п” 
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// СВапк 

ТМРЕЕМЕМТ _ОУМСВЕАТЕ(СВапк, ССтаТагде+) 

(Вапк: : СВапк() 

{ 
Епаб1еАитота+1от(); 
// То Кеер +пе арр11сат1оп гипп1пд аз 1014 аз ап ОЁЕ аифота оп 
// об]есе 13 аст1\ме, +пе сопзегистог са115 АТХО1еЁоскАрр. 
АРХО1еЁоскАрр(); 
п_ОВа1апсе = 0.0; 

} 

СВапк: : "СВапк() 

{ 
// То фегтапаже пе арр11са1оп мпеп а11 о6]есф$ сгеафед матп 
// мАЕП ОЕЕ аифотаф1оп, {пе дезтгистог са11$ АРхХО1е/п1оскАрр. 
АГхО1е/п1оскАрр(); 

} 

у01а СВапк: :ОпЕ1па1Ве1еазе( ) 

{ 
// Мпеп пе 1аз{ геРегепсе Рог ап аиотат1оп оБ]есе 13 ге1еазед 
// ОпЕ1па1Ве1еазе 1$ са11ед. Тне базе с1аз$ 111 аитота{1са11у 
// де1ете {пе оБ]ес+. Ада ада1+1опа1 с1еапир геди1гед Гог уоиг 
// обЗесе БеГоге са111п9 +не Базе с1азз. 
ССтаТагде*: :ОпЕ1па1Ве1еазе(): 

} 

ВЕСТМ_МЕЗЗАСЕ_МАР(СВапк, ССтаТагдет) 

ЕМО_МЕЗЗАСЕ_МАР() 


ВЕСТА _ОТЗРАТСН_МАР(СВапк, ССтаТагоает) 
ОТ$Р_РИМСТТОМ_ТО(СВапк, “\1ЕИагамат”, 91$р19\1 {Пагама1 
М1{Нагама1, УТ_А8, УТ$_В8) 
ОТ$Р_РИМСТТОМ_ТО(СВапк, “Оероз1+”, 91$р1адероз1т, 
Оероз1+, \УТ_ЕМРТУ, УТ$З_В8) 
ОТ5Р_РВОРЕВТУ_ЕХ_ТО(СВапк, “Ва1апсе", 91$р1аВа1апсе, 
Се{Ва1апсе, Зе{Ва1апсе, \Т_В8) 
ЕМО_ОТЗРАТСН_МАР( ) 


// №те: ме ад зиррогЕ Рог Т19_ТВапк о зиррогЕ ТурезаРе 61п4а1пд 
// Тгот УВА. ТИ1$ 110 тизЕ мафсй +пе СИТО тпа+ 1$ аефаспеа фо +пе 
// а1зрапфегРасе 1п пе .ТОЕ Е11е. 


78 {8ВАО2ВОС-620С-4952-8116-С7360А06858Е} 
ЗТа{1с сопзЕ ТТО Т1О_ТВапк = 
{ Ох8ВАО2ВОС, 0х62СС, 0х4952, 
{ 0х81, 0х1С, 0хС7, 0х36, ОхОА, 0х6, 0х85, Ох8Е } }: 


ВЕСТМ_ТМТЕВРАСЕ_МАР(СВапк, ССтаТагдет) 
ТМТЕВРАСЕ_РАВТ(СВапк, ТТО_ТВапк, 01зратсп) 
ЕМО_ТМТЕВРАСЕ_МАР() 


// {ЗЕС6бРАЗ9-9Р9Е-4619-9Е62-ВАБЕЕЗ7176ЕО} 
ТМРЕЕМЕМТ_ОГЕСВЕАТЕ_РЕАС$(СВапк, “Ех2За.Вапк" 
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агхНедАрагетеп{Тпгеа91т9, ОхЗесбта59, Ох9т9г, 
0х4619, Охэг, 0х62, Оха, Ох5Е, 0хез, 0х71, 
0х76, 0хгО) 

// СВапк теззаде папа1егз 


Эта первая версия программы Ех23а работает в режиме единственного про- 
цесса, как и программа АшосИск. Если второй клиент АшотаНоп запрашивает 
второй объект СВапк, СОМ вновь вызывает функцию Стешетяатсе фабрики класса, 
и существующий процесс конструирует в куче новый объект СВапё. Это можно 
проверить, создав копию рабочей книги Ех23а.х15 под другим именем и загрузив 
и копию, и оригинал. Щелкните кнопку Гоаа ВапК Ргозгат в обеих книгах и про- 
следите за сообщениями в окне ОеБае. Процедура иШпияапсе должна вызываться 
только раз. 


_ Отладка програм 1Е ЕХЕ-к‹ 


Вгомзе ТпРогтавог, 
Ву ЕуегЕ5 
Сизвот Вий Эвер 
\\еБ ВеГегепсез 


ие или нажатия клавиши 5 _ 


можно. запустить ИЗ 
ых ис 
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Пример Ех23Ь: О--компонент АмотаНоп 


Ех23а можно легко переделать из ЕХЕ-варианта в Р!1. Класс СВапё при этом не 

изменится, а макросы Ехсе! будут очень похожи. Однако интереснее написать новое 

приложение, на этот раз с минимальным пользовательским интерфейсом. При- 

меним в нем модальное диалоговое окно, поскольку на практике это максимум 

того, что можно сравнительно беспроблемно добавить в О, Ащоютанолп. 
Программа Ех23Ь довольно проста. Класс компонента АшотаНоп, определяе- 

мый по регистрируемому имени Ех23Ь.Аиго, имеет такие свойства и методы: 

Название Описание 

опора Свойство типа длинное целое 

Теда Свойство типа ИАЮАМТ 


рёрауров Метод без параметров, возвращает ВООГ 


рёр/ауГщов отображает диалоговое окно для ввода данных (рис. 23-4). Мак- 
рос Ехсе! передает ОМ, значения двух ячеек, а потом обновляет эти же ячейки 


новыми значениями. 


Рис. 23-4. Диалоговое окно ОИ-библиотеки Ех236 в действии 
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ти 5 аз его 
“техе” — 
м мотноат рака, 


° Правила, применяемые УВА по у 
_ зывая перед параметром к 


Этот пример изначально сгенерирован средствами МЕС ОШ, У/гага как обыч- 
ная МЕС ОМ, с установленными переключателем Везиаг ОЛ, ие звагеа МЕС ОШ, 
и флажком Ашотаноп. Вот как подготовить и протестировать О,-сервер Ех23Ъ, 
используя код с компакт-диска. 


1. Откройте в У151а1 $та410 „МЕТ решение \усррпе \Ех235\Ех23Ъ.$1п. Собе- 
рите проект. 

2. Зарегистрируйте О. Можете использовать для этой цели программу ВезСотр 
из каталога \усрр32\Везсотр\Вееа$е компакт-диска, которая открывает диа- 
логовое окно, упрощающее выбор ОГ-файла. Впрочем, вы вправе применить 
стандартную утилиту Кез5уг32.ехе. 

5. Откройте Ехсе! и загрузите файл \усррпе \Ех236\Ех23Ъ.х15$. Введите це- 
лое число в ячейку СЗ и какой-нибудь текст в ячейку 03 (см. рис. на следую- 
щей странице). 

Щелкните кнопку Гоаа РЦ, затем — кнопку баег Раца. Введите данные, 
щелкните кнопку ОК и посмотрите на новые значения, появившиеся в элект- 
ронной таблице. 
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4. Щелкните кнопку Опоа@ О. Если вы запустили ОШ, (и Ехсе!) из отладчи- 
ка, просмотрите окно РеБиз и убедитесь, что в РИ, вызвана функция ЕхИти$аисе. 


'САРгодгат Рйез\Мегозой: ОРйсе\ОРИсе10\ЕХ. 


{33 меб пеГегепсе5 


5 \меь рерюутеге 
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Теперь обратимся к коду Ех23Ъ. Как и в МЕС ЕХЕ, в обычной РИ, на базе МЕС 
есть класс приложения (производный от СИмАрр), а также глобальный объект- 
приложение. Переопределенная функция ийияаисе в Ех23Ь.срр выглядит так: 


ВОО СЕх23ЗБАрр: : Тп1Тизфапсе( ) 

{ 
ТВАСЕ( “СЕх2ЗБАрр: : Тп1Тпзфапсе\п") 
С\1пАрр: : Тп1Тпзфапсе() 


// Ведлзфег а11 ОЕ зегуег (Гастог1ез) аз гипп1пд. 11$ епаб1ез +пе 
// ОКЕ 116гаг1е$ +0 сгеафе обзестз гот офпег арр11са{10п$. 
С01е06}естРастогу: :Вед1$1егА11(): 


гефигп ТВОЕ 


В программе есть код для трех стандартных экспортируемых функций СОМ ОИ; 


ЗТВАРТ 0116е+С1аззО6]ес(ВЕРСЕЗТО гс1$1а, ВЕРТТО г119, ЕРУОТО* рру) 
{ 
АРХ_МАМАСЕ_ЭТАТЕ( АТхбеттат1сМоди1езтате()); 
гефигп АГхО116е{С1а$з06)ес+(гс1$14, г119, рру): 
} 
// 011Сапуп1оад№ м - А110\м$ СОМ фо ип1оаа 9. 
ОТОАРТ 011Сап/п1оааМ№ м (мо1а) 
{ 
АРХ_МАМАСЕ_ЗТАТЕ( АРхбе{Зта{1сМоди1е$ате()): 
гефигп АРх011СапИп1оаа№ м(); 
} 
// 011Вед1зтегЗегуег - Адаз епЕг1ез фо тне зузфет гед1з{гу 
ЗТОАРТ 011Вед1зтегЗегуег(\о1а) 
{ 
АРХ_МАМАСЕ_ЗТАТЕ( АРхбет$ат1сМоди1етате()); 


17 (!АРхО1евед1+егТуреЕ 16 (АРхбетТпзтапсеНапа1е(), _111а)) 
гефигп ЗЕЁЕЕВЕб_Е_ТУРЕЕТВ; 


1 (!С01е06}есРастогу: : Урдатевед1$1гуА11()) 
гефтигп ЗЕЁГЕАВЕС_Е_С1А$$5; 


гетигп 5_ОК; 
} 
// 011/пгед1з+егбегуег - Ветомез епег1ез гот 1Не зузфет гед1$гу 
ЗТБАРТ 011/пгед1${егегуег(\019) 


{ 
АРХ_МАМАСЕ_ЗТАТЕ( АРхбет$ат1сМоди1езтате()):; 


ТР (| АРхО1е/пгедазтегТуреЕ1 (+119, _м\егМа]ог, _м\егМ1пог)) 
гетигп ЗЕЁЕЕВЕб_Е_ТУРЕЕТВ; 


Е (!С01е063есфРастогу: : Урдатевед1$1гуА11 (РАЕЗЕ) ) 
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гетигп ЗЕГЕВЕЯ_Е_С1А$5; 


гетигп $_ОК; 


Код класса СРготрЮ находится в файле РготрИз.срр. Но это стандартный 
класс производный от СБйщов. Файл РготрИ) 2.6 содержит заголовок этого клас- 
са. Нам более интересен класс компонента Ацютайоп СЁЕх23ЬАию, изначально 
сгенерированный АЧА С1а$5$ УЛ2ага (с параметром СгезжеаЫе Бу гуре 1). Этот класс 
доступен СОМ под программным идентификатором Ех235.Ех23БАшю. Так выгля- 
дит листинг заголовочного файла Ех25БАигю.В. 


А это файл реализации Ех23ЪАиго.срр. 


см. след. стр. 
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Свойства Гоп8)еа и 1ехДеца представлены переменными-членами 7 Шеа и 
т_паТехШеа, инициализируемыми в конструкторе. Когда вы добавили в мастере 
Аа Ргорепу УЛгагА свойство ТопеБаиа, была определена уведомляющая функция 
ОшопзреиасСвапвеа. Она вызывается всякий раз, когда контроллер изменяет зна- 
чение свойства. Такие функции можно задать только для свойств, представленных 
переменными-членами. Не путайте эти уведомления с теми, что АсНуеХ-элемен- 
ты посылают своему контейнеру при изменении связанного свойства. 

Функция-член Рёр/ауОйжов, реализующая одноименный метод, проста, если не 
считать того, что для очистки указателей на временные объекты нужны функции 
АросЕТетрМарз и АИтюсЕТетрМарз (обычно такая операция осуществляется в 
холостом цикле ЕХЕ-программы). 

А как насчет УВА-кода в Ехсе!? Вот три макроса и глобальные объявления: 


01т 011сотр Аз ОБуес+ 
Рг1уате Оес1аге биб СоЕгее/пизед1Ьгаг1ез [16 “ОЕЕЗ2" () 


Зи6 [0а9011Сотр() 
ее 011сотр = Сгеафе06 ест ("Ех2ЗЬ. Ех2З6Аи+о") 
Вапде ("СЗ"). Зе1ес+ 
011сотр. Гопобата = Зе1есе1оп. Уа1ие 
Вапде( "03". Зе1ес+ 
011сотр. ТехЕбафа = Зе1ес+1оп. \а1ие 
Епа Зи6 


бир Вегезп011Сотр() 'Кнопка бафпег бата 
Ваподе ("СЗ"). Зе1ес+ 
011сотр. Гопобата = Зе1ес+1оп. Уа1ие 
Ваподе ("03"). Зе1ес+ 
011 сотр. Тех{бата = Зе1есе1оп. Уа1ие 
011 сотр. 01$р1ау01а109 
Вапде( СЗ"). Зе1ес+ 
Зе1ес1оп. Уа1ие = 011сотр. Гопдбафа 
Вапде ("03"). Зе1ес+ 
бе1ест1оп. Уа1ие = 011сотр. Тех+бата 
Епа $и6 


Зи6 Уп10а9011Сотр() 

Зет 011сотр = №11119 

Са11 Соггее/пизечЕ16гаг1ез 
Епд Зи6 


Первая строка в ГоваИСотр создает объект компонента в соответствии с за- 
регистрированным именем Ех23Ъ.Ех23ЪАио. Макрос КееРИСотр обращается 
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к свойствам этого объекта Тех Шеа и ГопаБиа. При первом запуске ГоаЯРИСотр 
загружается РИ, и создается объект Ех23ЬАию. При втором происходит нечто 
любопытное: создается второй объект, а первый удаляется. Запустив Гоа ОИСотр 
из другой копии рабочей книги, вы получите два отдельных объекта Ех23Ь.Ашю. 
Конечно, в памяти только одна копия Ех23Ъ.а1, если только вы не запустили не- 
сколько экземпляров Ехсе!. 

Присмотримся к макросу ОпюаарИСотр. Следующий оператор заставляет Ехсе! 
отсоединить ОМ, но из адресного пространства Ехсе!| она не выгружается, а зна- 
чит, функция компонента ЕхИтЯаисе не вызывается. 


ет 011сотр = №111п9 


Функция СоЁгееО/пизеИртаех вызывает для каждой компонентной ОШ, экс- 
портируемую функцию РИСапОпюааМоил и, если функция возвращает ТКИЕ, ос- 
вобождает РИ. Программы на базе МЕС вызывают СоЁЕгееИпизеИртаез в холос- 
том цикле (с минутной задержкой), но Ехсе! этого не делает. Вот почему Ипюая0й- 
Сотр должна вызывать СоЁтееИпизе И рта е$ после отсоединения компонента. 


Пример Ех23с: $0!-приложение АшотаНоп 
в виде ЕХЕ-компонента с пользовательским интерфейсом 


Этот пример компонента Ащотайоп иллюстрирует применение класса документа 
в качестве компонентного класса в $П!-приложении, где для каждого объекта за- 
пускается отдельный процесс. Здесь также демонстрируется индексируемое свой- 
ство и метод, конструирующий новый СОМ-объект. 

В первом компоненте АшотаНоп — Ех23а — не было пользовательского ин- 
терфейса. Глобальная фабрика классов создавала объект СВапЕ, который делал всю 
работу. А если нужен ЕХЕ-компонент с окном? Если вы уже разбираетесь в архи- 
тектуре «документ-вид», поддерживаемой МЕС, то наверняка не откажетесь задей- 
ствовать все ее преимущества. 

Допустим, вы создали обычное МЕС-приложение и добавили к нему класс (на- 
пример, СВап®), который можно создать посредством СОМ. Как связать объект 
СВапй с документом и его представлением? Из функции-члена класса СВапЁ вы 
могли бы перейти через объект-приложение и основное окно к текущему доку- 
менту или объекту «вид», но в МО!-приложении это не так просто, особенно при 
наличии нескольких объектов и документов. Есть способ получше: предусмотреть 
в классе документа возможность его создания по СОМ — МЕС АррИсаНоп УЛ2ага 
поддерживает это и в МП]-, ив $О]-приложениях. 

МО!-приложение АщосИск демонстрирует, как СОМ инициирует создание 
нового документа, окна представления и дочернего окна-рамки всякий раз, когда 
контроллер автоматизации создает новый объект компонента. Ну, а поскольку 
Ех25с — 5О1-приложение, УЛп4о\$ при создании клиентом нового объекта запу- 
скает новый экземпляр программы. Сразу после запуска программы СОМ при по- 
мощи каркаса приложения МЕС создает не только документ, поддерживающий 
АиютаНоп, но и окно представления и основное окно-рамку. 

Поэкспериментируем с приложением Ех25с, изначально сгенерированным МЕС 
РИ, УЛрагА с установленным флажком АшотаНоп. Оно представляет собой про- 
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грамму-будильник с оконным пользовательским интерфейсом, предназначенную 
для управления клиентом АшотаНо, таким как Ехсе|. Вот свойства и методы Ех23с. 


Название Описание 

Гите Свойство типа ДАТЕ, содержащее дату в формате СОМ (т _иаТипе) 

Ивите Индексируемое свойство типа УАМАМТ для четырех цифр на циферб- 
лате (т зтЕвите!]) 

Кетезрт Метод, объявляющий окно представления недействительным и поме- 
щающий основное окно-рамку поверх других окон (Кейезр) 

Зрош\т Метод, отображающий основное окно приложения (5рои\И) 

СтешеФатт Метод, создающий объект СА/агт и возвращающий указатель его ин- 


терфейса ШёбресЬ (Стешеатт) 


Чтобы создать и запустить программу Ех23с с компакт-диска, сделайте так. 


1. Откройте в У15а1 51а410 „МЕТ проект \усррпе \Ех23с\Ех23с.$1п. Собери- 
те проект, чтобы получить файл Ех23с.ехе в подкаталоге БеБие проекта. 

2. Запустите программу один раз для ее регистрации. Программа может 
работать как автономное приложение или как компонент Ашотаноп. При 
запуске из УЛп4о\у$ или из У150а1 Зв ю „МЕТ она обновляет реестр и отобра- 
жает циферблат часов с римскими цифрами ХП, Ш, УТ и [Х в соответствующих 
позициях. Закройте приложение. 


3. Загрузите в Ехсе! файл \усррпе \Ех23с\Ех23с.х15. Таблица выглядит так: 


Щелкните кнопку Гоа4 С!оск, затем дважды (два одинарных щелчка) — кноп- 
ку Зе! А!агт (после щелчка кнопки Тоа4 С!оск может быть длительная задерж- 
ка). На экране должны появиться часы с буквой А — индикатором того, что бу- 
дильник установлен. 

Если вы запустите компонент под управлением отладчика, сможете уви- 
деть в окне ОеБиз, когда была вызвана ийтяапсе и когда был создан объект- 
документ. 

Если вас удивляет отсутствие меню в окне будильника, причина тому — 
наличие в СМатЕгате::РгеСтещетаои; оператора: 


с$.ИМепи = МИ; 
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4. Завершите программу С1осК, а затем щелкните кнопку Опюа4 СШоск. Если 
компонент запущен из отладчика, в окне Оериз появится сообщение о вызове 
функции ЕхИтЯатсе. 


Наибольшую часть работы по созданию документа как компонента АмотаНоп 
проделал МЕС АррИсайоп УЛгага. В производном классе приложения СЕх23сАрр 
он сгенерировал для компонента переменную-член: 


ру611с: 
С01еТетр1афезегуег м_зегуег; 


МЕС-класс СОеТетриже$етоег наследует СОеОБесЕасюту. Он создает СОМ- 
объект «документ» при вызове клиентом /С/я55Еасюгу::Стещетяатсе. Идентифи- 
катор класса хранится в глобальной переменной с/5 9, определенной в файле 
Ех25с.срр. Программный идентификатор (Ех23с.Ооситепо) находится в строко- 
вом ресурсе /2К_МАШУЕКАМЕ. 

В функции ийияатсе (файл Ех23с.срр) МЕС АррИсайоп УЙтага сгенерировал 
код, подключающий компонентный объект (документ) к шаблону документа: 


0С51191е0осТетр1ате» ‘рбосТетр1ате; 
рдосТетр1афе = пем С51п91ебосТетр1ате( 
ТОВ_МАТМЕВАМЕ, 
ВОМТТМЕ_С1А$$(СЕх23с0ос), 
ВОМТТМЕ_С1А$5(СМа1пЕгаме), // та1лп 5ОТ Ргате м1пдом 
ВИМТТМЕ_С1АЗ$ (СЕх23Зс\1ем)); 
АдабосТетр1ате(рбосТетр1ате); 


п_зегуег, СоппестТетр1ате(с1$19, рбосТетр1афе, ТВуЕ); 


Теперь все готово для того, чтобы СОМ и каркас приложений смогли создать 
документ вместе с окном представления и окном-рамкой. Однако формирование 
объектов не влечет автоматического вывода основного окна на экран. Это уже ваша 
работа — пишите соответствующий метод. 

Следующий вызов ОрашеКе и! в функции иШпЯапсе обновляет реестр УЛп- 
4о\з на основе строкового ресурса П2К_МАУЕКАМЕ: 
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п_зегуег. УрдафеАед1$Тгу(ОАТ_ОТЗРАТСН_ОВУЕСТ); 


Взгляните на карту диспетчеризации в файле Ех23<Рос.срр с методам и свой- 
ствами класса СЕх23сОос. Обратите внимание: Рите — индексируемое свойство, 
которое Ада Ргорепу УЛгагА может сгенерировать сам, если вы укажете ему под- 
ходящий параметр. Код, необходимый для функций бешвите и 5ейрите, мы рас- 
смотрим позднее. 


ВЕСТМ_ОТЗРАТСН_МАР(СЕх2Зсбос, Сбоситеп*) 
ОТ5Р_РВОРЕВТУ_МОТТЕУ_ТО(СЕх23с0ос, “Т1те" 
915р1аТ1те, п_+1те, ОпТ1тебвапдед, УТ_ВБАТЕ) 
ОТ$Р_РУМСТТОМ_ТО(СЕх23 сос, “Зпомм\ап" 
015 р1а5пом\1п, Эпом\ т, УТ_ЕМРТУ, УТ$_МОМЕ) 
ОТЗР_РУМСТТОМ_ТО(СЕх23с0ос, “СгеатеА1агт”, 
915$р19СгеатеА1агт, СгеатеА1агт, УТ _ОТЗРАТСН, \УТ$_БАТЕ) 
ОТЗР_РУМСТТОМ_ТО(СЕх23сбос, “Ветгезпи\1т”, 
915р1аАеггезви1т, Веггезпи1п, \Т_ЕМРТУ, УТ$_МОМЕ) 
ОТ5Р_РАОРЕАТУ_РАВАМ_ТО(СЕх23с0ос, “Е1диге“, 
915р19719иге, бетР1диге, ЗетЕ1диге, УТ_\МАВТАМТ, Ут$_12) 
ЕМО_ОТЗРАТСН_МАР( ) 


Методы Керезр\т и 5$рош\т не представляют особого интереса, но метод 
Стешейатт заслуживает особого внимания. Вот как выглядит соответствующая ему 
функция-член Суежщейатт: 


ТО13рафсп»* СЕх23Зс0ос: :СгеафеА1агт(ОАТЕ 11те) 
{ 
АРХ_МАМАСЕ_ЗТАТЕ( АРхбетАррМоди1е${ате()): 
ТВАСЕ(“Епег1пд СЕх23с0ос: :Сгеатед1агт, +1те = %+Р\п”, {1те); 
// ОГЕ уничтожает все существующие объекты СА1агт 
П_рА1агм = пем СА1агт(11те): 
гефигп т_рА1агт->беттТО1зратси(РАЕЗЕ); // АдавеЕ не используется 


Мы предпочли, чтобы компонент создавал объект СА/атт, когда контроллер 
вызывает метод Стещеатт. Сатт — это класс компонента АишотаНоп, который 
мы сгенерировали при помощи АЧА С!а3$ \12ага. В нем не предусмотрено созда- 
ние его объектов через СОМ, чем и обусловлено отсутствие для этого класса мак- 
роса ГМРЕЕМЕМТ_ОГЕСКЕАТЕ и фабрики классов. Функция СуешеАатт создает 
объект САмтт и возвращает указатель на его интерфейс ёрасЬ. (Параметр ЕАГЗЕ, 
передаваемый в ССтАТатвее:СеИрвракь, означает, что счетчик ссылок не увеличи- 
вается; счетчик ссылок на объект СА/ати уже установлен в 1 при создании объекта.) 

Класс Саут объявлен в А!агто.В так: 


#ргадта опсе 
// СА1агт соттапа тагдет 
с1аз$ СА1агт : риуб11с ССтаТагде+ 
{ 

ОЕСТАВЕ_ОУМАМТС ( СА1агт) 
риб11с: 

СА1агт(ВАТЕ +1те); 

У1гфиа1 “СА]агт(): 
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\1гфиа1 у0149 ОпЕ1па1Ве1еазе(); 
БАТЕ м_11те; 


рготестед: 
ОЕСГАВЕ_МЕЗЗАСЕ_МАР() 
ОБЕСТАВЕ_ОТЗРАТСН_МАР() 
ОЕСГАВЕ_ТМТЕВРАСЕ_МАР() 
\0149 ОпТ1меСпапдед (\014); 


епит 
{ 

91$р1аТ1те = 1 
# 


Обратите внимание на отсутствие макроса РЕСГАКЕ РУМСКЕАТЕ. 
В файле А!агт.срр содержится карта диспетчеризации: 


ВЕСТМ_ОТЗРАТСН_МАР(СА1агт, ССтаТагдет) 
ОТЗР_РВОРЕНТУ_МОТТЕУ_ТО(СА1агт, “Т1те“, 
91$р19Т1те, м_{1те, ОпТ1теСпапдеа, \УТ_ВАТЕ) 
ЕМО_ОТЗРАТСН_МАР() 


Для чего нам класс САмтт? Вместо него мы могли бы добавить в класс СЕх23срос 
свойство Аатт/Гите, но тогда для включения и отключения подачи сигнала будиль- 
ником понадобилось бы другое свойство или метод. Чего мы действительно до- 
бились, введя класс САатт, так это поддержки набора сигналов. 

Для реализации набора сигналов мы могли бы написать еще один класс — 
СсФатт$ с методами Ада, Кетоге и Пет. Назначение первых двух понятно (добав- 
ление и удаление отдельных элементов набора), а Пет возвращает указатель 102&- 
рейсь элемента набора, задаваемого индексом, числом или чем-то еще. Мы также 
могли бы реализовать свойство Соитё, доступное только для чтения и возвраща- 
ющее число элементов. В классе документа, в котором содержится набор, был бы 
метод А/ягт5 с необязательным параметром типа УАЮАМТ. Если этого параметра 
нет, метод возвращает указатель на /ОбрасЬ для набора, а если в параметре задан 
индекс — указатель на /Оёбраюр для выбранного сигнала. 


Примечание Пожелай мы, чтобы набор поддерживал характерный для УВА син- 
таксис типа «Еог ЕасВ», нам пришлось бы проделать кое-что еще. К классу 
САагт5$ надо было бы добавить интерфейс ([ЕпитУАМАМТ и реализовать 
функцию-член №2 этого интерфейса для прохода по элементам набо- 
ра. Затем ввести в класс САмт$ метод _М№ешЕпит, возвращающий ука- 
затель на интерфейс 1ЕпитУАЮМАМТ. А чтобы набор был универсальным, 
нужно было бы разрешить создание отдельных оббектов-перечислите- 
лей (епатегатог оБесй) (с интерфейсом {[ЕпитУАЮМАМТ) и реализовать 
другие функции /ЕпитИапаиЕ 5Юр, Кезеги Срюпе. 


Свойство Е12игез интересно тем, что допускает индексацию. Оно представля- 
ет четыре числа из римских цифр на циферблате часов: ХИ, Ш, У! и [Х. Свойство 
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реализовано как массив С5Итв, так что применение римских цифр вполне допу- 
стимо. Объявление в Ех23сРос.В выглядит так: 


риб11с: 
С$г1п9 м_зЕиР1диге[4] 


А функции Сей вите и 5ейрвите в Ех23сВос.срр реализованы так: 


\АВТАМТ СЕх23с0ос: : беёЕ1диге($НОАТ п) 
{ 
АЕХ_МАМАСЕ_5ТАТЕ( АР хбетАррМоди1е тате()); 
ТВАСЕ( “Епфег1п9 СЕх23с0ос: : беЕЕ1диге - п = %4 м_згЕ1диге[п] = %э\п" 
п, М $гЕ1диге[п]) 
гефигп С01е\/аг1ап(т_з+гРлдиге[п]). бефасп():; 
} 
\01а СЕх23с0ос: : ЗетЕ1диге(ЭНОАТ п, УАВТАМТ ЕАВ& пем\а1) 
{ 
АРХ_МАМАСЕ_ЗТАТЕ( АР хбетАррМоди1етате()); 
ТВАСЕ( "Епфег1пао СЕх23с0ос: : Зе{Е1диге - п = %9, \+ = %а\п", п 
пем\/а1.\т); 
С01е\аг1ап{ уаТетр; 
уаТетр. СпапдеТуре(УТ_В$ТН, (С01е\аг1апт*) &пем\а1): 
м_$иР1диге[п] = уаТетр. 6$4г\а1; // преобразует двухбайтовую строку в однобайтовую 
е{Мод111е9Е1ад(); 


С этими функциями связан макрос 2/5Р_РКОРЕКТУ РАКАМ из карты диспетче- 
ризации класса СЕх23сос. Первый параметр функций — индекс, заданный послед- 
ним параметром макроса как тип короткое целое. Индексы свойств не обязатель- 
но должны быть целыми числами и могут состоять из нескольких компонентов 
(например, номеров строки и столбца). Вызов С‚апвеТуре в 5ейвите обязателен, 
иначе контроллер передаст вместо строк числа. 

Мы только что рассмотрели свойства-наборы и индексируемые свойства. Чем 
они различаются? Контроллер не может добавлять и удалять элементы индекси- 
руемого свойства, но может делать это в наборе. 

Какая функция рисует циферблат? Как вы, наверное, и ожидали, этим занима- 
ется функция Оирта класса «вид». Функция использует Сейоситет, чтобы по- 
лучить указатель на документ, а затем обращается к переменным-членам и функ- 
циям-членам, соответствующим свойствам и методам. 

И, наконец, код макроса Ехсе|: 


01т С1оск Аз 063ес+ 
01т А1агм Аз 06) ест 


биб ГоааС1оск() 
ее С1оск = Сгеате0Б ест (“Ех23с.Боситеп+") 
Вапде( "АЗ". Зе1ес* 
п=0 
о Цпт11 п = 4 
СТоск. 119иге(п) = Зе1ес\1оп. Уа1ие 
Зе1есЕ1оп. ОРЕзет(0, 1).Вапде("А1”). Зе1ес+ 


ГЛАВА 23 АщотаНоп 6537 


пП=п+1 
обор 
НеггезпС1оск 
СТоск. помп 
Епд 5и6 


биб НетгезНС1оск() 
СЛоск.Т1те = №м() 
СЛоск. Неггезп\1 п 
Епа $и6 


биб СгеатеА1агм() 
Вапае("ЕЗ”). Зе1ес+ 
Зет А1агт = С1оск. СгеатеА1агт( Зе1ест1оп. \Ма1ие) 
ВеггезпС1.оск 

Епа 5и6 


Зиб Ип1оа9С1оск() 
еф С1оск = №+111п9 
Епа Зи6 


Обратите внимание на оператор 5е! Аатт в макросе Стешеатт. Он вызывает 
метод Стеще@атт, чтобы получить указатель на /Оёрась, сохраняемый в объек- 
тной переменной. Запустив макрос повторно, вы зададите новый будильник, но 
при этом уничтожите старый, так как его счетчик ссылок обнулится. 


Внимание! Вы видели модальное диалоговое окно в ОШ, (пример Ех23Ь) и 
основное окно-рамку в ЕХЕ-модуле (пример Ех23с). Будьге осторожны 
с модальными диалоговыми окнами в ЕХЕ. Диалоговое окно АБош, вы- 
зываемое прямо из компонентной программы, — вещь нормальная, но 
активизация модального диалогового окна из функции-метода внешне- 
го компонента — идея не из лучших. Проблема в том, что, когда на эк- 
ране открыто модальное диалоговое окно, пользователь, может вновь 
переключиться на клиентскую программу-контроллер. МЕС-контролле- 
ры реагируют на это, открывая окно с сообщением о занятости сервера 
(Зегуег Виэу). Ехсе! поступает аналогично, но перед этим зачем-то вы- 
жидает 30 секунд, что часто сбивает с толку. 


Пример Ех234: клиент АмотаНоп 


Итак, вы познакомились с примерами компонентов АщотаНоп. Теперь перейдем 
к примеру клиентской программы АшотаНол на С++, которая запускает все эти 
компоненты, а также управляет работой М1сгозой Ехсе!. Программа Ех234 изна- 
чально сгенерирована МЕС АррйсаНоп УЛ ага, но без установки флажков, связанных 
с СОМ. Проще добавить относящийся к СОМ код вручную, чем удалять код, свя- 
занный с компонентом. Если же вы все-таки решите генерировать подобный кон- 
троллер АиютаНоп с помощью МЕС АррИсаНоп УЛгага, добавьте в конец ${ААЁх.В 


строку: 
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#1пс1и4е <аРха1зр.п> 
а в начало ИипиЯапсе приложения — вызов: 


АРхО1е1п11(); 


Чтобы подготовить исполняемый файл Ех234, откройте и соберите решение 
\усррпе \Ех23а\Ех234.51п. Запустив программу под управлением отладчика, вы 
увидите стандартное 5П-приложение, с такой структурой меню (рис. 23-5): 


Гоад Е оад оад оад 
Тез! бе! Баа Сгеае А!апт Ехесще 
Упюад Упюад Венезй Тите 

Упюа@ 


Рис. 23-5. Структура меню $0!-приложения Ех23а 


Собрав и зарегистрировав все компоненты, можете протестировать их с по- 
мощью Ех254. Заметьте: ОШ.-компоненты не обязательно размещать в каталоге 
\УПпов\5у$еп132, так как УЛпао\з отыскивает их по информации в реестре. Для 
некоторых компонентов, чтобы убедиться в правильности результатов теста, при- 
дется вывести окно Пери?. Программа Ех234 достаточно модульна. Команды меню 
и события, связанные с обновлением пользовательского интерфейса, направля- 
ются в класс «вид». У каждого компонентного объекта свой класс С++ контролле- 
ра и внедренная переменная-член в Ех23А\1е\.В. Мы рассмотрим каждую часть 
программы по отдельности, но сначала разберемся с библиотеками типов. 


Библиотеки типов и 101 -файлы 


Мы уже говорили, что библиотеки типов в МЕС-реализации Рёреср не нужны, 
но У150а| 5 ю МЕТ все равно «втихую» генерирует их для всех создаваемых ком- 
понентов. В чем их польза? Дело в том, что УВА они могут понадобиться для про- 
смотра методов и свойств компонента и для ускорения доступа к методам и свой- 
ствам в процессе раннего связывания (еайу М1па!1?), о котором мы поговорим чуть 
ниже. Но мы ведь создаем здесь клиентскую программу на С++, а не на УВА. Ока- 
зывается, АЧА С1а$$ УЯ2агА способен — по информации из библиотеки типов ком- 
понента — генерировать код С++, позволяющий контроллеру «управлять» компо- 
нентом АиютаНоп. 
вн 
Примечание МЕС АррИсайоп У/агА инициализирует ШТ--файл (пиегасе Рейп:- 
поп Гаприазе — язык описания интерфейсов) при создании проекта. 
Мастера Ааа Ргорегу УЛгага и Аа Мефоа У/1хаг4 обновляют этот файл 
всякий раз, когда вы генерируете новый класс компонента Ашщотайоп 
или добавляете свойства и методы к существующему классу. 


Когда вы добавляли свойства и методы к классам компонентов, Ааа Метоа 
УЛлага и Ада Ргорему УЛ2ага обновляли ШГ-файл проекта. Это текстовый файл, 
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описывающий компонент на языке описания объектов. Ниже приведен ШТ-файл 
для банковского компонента (если вы сгенерируете этот проект с помощью МЕС 
АррИсайоп УЛгага, СОТ в вашем файле будет другим). 


// Ех2За.191 : туре 116гагу зоигсе Рог Ех2За. ехе 
// ТВ1$ Р11е м111 Бе ргосеззед Бу 1Не МТОЁ сотр11ег +0 ргодисе +пе 
// %уре 116гагу (Ех2За. 116). 
Н1ис1иде “о1ест1. п” 
[ ци19(608СА702-1401-4832-А278-50670609975Е), \егз1оп(1.0) ] 
116гагу Ех2За 
{ 
1трог{116("31901е32.116”); 
11рог{116("$1901е2.116") 


// Рг1магу Ч91зрафсй 1птегГасе Гог СЕх2Задос 
[ ци19(17013122-ЕАЗО-414Е-В58Е-5А31Аб4ЕА505) ] 
915р1птегРасе ТЕх2За 
{ 
ргорег{1ез: 
тетпо4$ : 
} 
// С1азз 1пРогта1оп Рог СЕх2За0ос 
[ чи19(5ЕЕ5С98С-5ССЕ-46Е4-9Е95-178С0623708В) ] 
с0с1аз$ Ех2За 
{ 
[9егаи11] 913р1птегТасе ТЕх23За; 
| 
// Рг1тагу Ч1зрафсй 1пфегРасе Рог Вапк 
[ чи19(8ВА02В0С-62СС-4952-811С-С7360А06858Е) ] 
91$р1птегГасе ТВапк 
{ 
ргорег{1ез: 
[19(3), пе1р$1г1п9("“ргорегфу Ва1апсе”)] БОУВЕЕ Ва1апсе: 
тетпод3: 
[19(1), пе1рз{г1п9("тефво9 М1И9гама1”)] 
ООЦВЕЕ \1{П9гама1 (ВОУВЕЕ ЧАтоип*); 
[19(2), пе1рз%г1п9(“тежпод Оероз1+”)] 
\0149 Оеро$11(ВОУВЕЕ ЧАтоип®); 
}; 
// С1аз$ 1пРогта1оп Рог Вапк 
[ чи19 (ЗЕС6РАБ9-9Е9Е-4619-9Е62-ВА5ЕЕЗ7176Е0) ] 
с0с1аз$ Вапк 
{ 
[9еРаи1{] 91зр1пфегРасе ТВапк 
} 
р 


ООТ-файл содержит уникальный СОШ-идентификатор библиотеки типов 60ВСА7О?- 
1401-4832-А278-50670С29975Е и полностью описывает свойства и методы в дис- 
петчерском интерфейсе (азримег!асе) 1Ваик. Кроме того, для А1рице!Еасе задан 
свой СОТ (8ВАР2В0С-62СС-4952-811С-С7362А06858Е), это тот же идентифика- 
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тор, что и в таблице интерфейсов класса СВапе. Смысл этого СОТ разъясняется 
в разделе «Раннее связывание в УВА» в конце главы. Для загрузки компонента УВА 
применяет идентификатор класса (ЗЕСбЕА59-9Е9Е-4619-9262-ВА5ЕЕЗ7176Е0). 

В любом случае У15иа! $ о „МЕТ при сборке проекта компонента вызывает 
утилиту МП, которая считывает ШТ-файл и генерирует двоичный ТГВ-файл в 
каталоге Рериз или Ка[еазе проекта. Теперь, когда вы создаете на С++ клиентскую 
программу, из ТГВ-файла проекта компонента можно сгенерировать с помощью 
Ааа С!а55 УЛ2ага управляющий (апуег) класс. 

Чтобы все это проделать, щелкните кнопку АЧА С!а5$ в меню Рго}ес! и в открыв- 
шемся окне выберите в списке шаблон МЕС С1а$$ Егот 'ТуретАЬ. Укажите ТГВ-файл 
проекта компонента, и АЧ4 С1а$$ УЛ2агА откроет диалоговое окно вроде этого: 


д99 С1а$% гот г 224 


Угесоте то {Пе А9д С1а$$ Егот ТурейБ МИгагЧ 
ТЫ ‘Мгаг4 а445 4а5зез Го усцг ргодесЕ Базеф оп пбе!асез зе/ескед {тот а Куре ШБгагу. 


1ВапЕ — это имя @зр-интерфейса, заданное в ШТ-файле. Можете, если хотите, 
сохранить это имя класса, а также задать имена заголовочного и СРР-файлов. Если 
в библиотеке типов не один интерфейс, можно выбрать сразу несколько интер- 
фейсов. Сгенерированный класс контроллера показан в следующем разделе. 


Класс контроллера для Ех2За.ехе 


Мастер Ааа С1а$$ Егот ТуреНЬ УЙгага сгенерировал класс [Вап® (производный от 
СОеррасЬО тет) (см. листинг ниже). Присмотритесь к реализации функций- 
членов. Обратите внимание на первый параметр в вызовах функций СеРторету, 
5еРторепу и тгоЕеНерет. Это жестко заданные 015Р-идентификаторы свойств 
или методов компонента в порядке, определенном в карте диспетчеризации ком- 
понента. 


В классе СЕх23 Ме есть переменная-член т_фапЕ класса 1Вапр. Функции-члены 
СЕх234Теш для компонента Ех23а.Вапк приведены ниже. Они вызываются при 
выборе команд из основного меню контроллера. В частности, представляет ин- 
терес функция ОпВапкоеГоаа. Функция СОерёрейсьОтьет::Стеие 5 рейсь загру- 
жает программу компонента вызовом Собеа5зОБес! и 1Аа55Еасюту::Сгеспетяапсе. 
Затем она вызывает Омегуриех/асе, чтобы получить указатель на /Оёрась, сохра- 
няемый в переменной-члене т _рОбрась. Функция СОерресьОтет::Кееазе- 
Рёреср, вызываемая из ОпВапкоеИтоаа, освобождает этот указатель вызовом 
Каеабе. 


\014 СЕх2За\1ем: :ОпВапко1еЁоа4() 
{ 
17(!п_бапк. Сгеате01зрафсв( "Ех2За.Вапк")) { 
АГхМеззадеВох( "Ех2За.Вапк сотропепе пот Тоипа"); 
гефигп; 
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\01а СЕх2За\1ем: :ОпИрдатевапко1е!1оа9 (ССтаит *рбтдит) 
рсмаут->Епаб1е(т_Бапк. т_1р01зратсн == ме): 

р СЕх2За\1ем: :ОпВапко1еТез\() 

п_Бапк. 0еро$11(20.0); 

т_бапк. М1 {Пдгама1 (15.0): 

ТВАСЕ(“пем ра1апсе = %1\п", м_Бапк. бетВа1апсе()): 
а СЕх2За\1ем: :Оп/рдатеВапко1еТез+(ССтаиТ «рСтаит) 
рСтаит->Епаб1е (п_вапк.м_1р01зратсй != МЕ): 
= СЕх2За\1ем: :ОпВапко1е/и1оад() 
| т_Бапк. Ве1еазе)1зратсв(); 

и. СЕх2За\1ем: :ОпИрдатеВапко1е\п1оа9 (ССтаит *рбтаит) 
рСтаут->Епаб1е(п_Бапк. м_1р01зратсв != МЕ): 


Класс контроллера для Ех2ЗЬ.Ч! 


На рис. 23-9 показан заголовочный файл класса, сгенерированный мастером Ааа 
С1а$$ Егот Турепь УЛгага. 
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Заметьте: для каждого свойства нужны отдельные функции СеЁ и $е1, даже если 
какое-то свойство представлено в компоненте как переменная-член. 
Заголовочный файл класса «вид» задает переменную-член 7 аию класса СЕх23Ь- 


Ашо. Ниже приведены функции-члены из Ех23А\1е\усрр — обработчики команд 
из Ех23А\ехусрр. 


\0149 СЕхаЗа\1ем: :0п01101ебетдата() 
{ 
п_аифо. 01$р1ау01а109(); 
С01е\/аг1ап{ уабата = т_аифо. бетТех{Вата(); 
АЗЗЕВТ (уабафа.\{ == \УТ_В$ТВ); 
С51г1п9 э+гТехеБата (\аата. 6$1г\а1); 
10опд 1Бафа = т_аифо. бе{Ёопабата(); 
ТВАСЕ( “СЕх2За\1ем: :0п01101ебетдата - 10п9 = %19, техе = %3\п", 
]1Бата, э{гТех{Бата); 
} 
\0149 СЕх2За\1ем: :Оп/рдатер1101ебетдата(ССмаут *«рСмаит) 
{ 
рСтаут->Епаб1е(т_аито. п_1р01зрафсй != Ми); 
} 
\019 СЕх2З9\1ем: :0п011о1е1оад() 
{ 
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11 (| п_аифо. Сгеате01зрафсй("Ех236. Ех2З6Аифо")) { 
АгхМеззадеВох ( "Ех2ЗЬ. Ех2ЗЬАито сотропепф пот Роипа”): 
гефигп; 

} 

С01е\/аглап{ уа(“\1езт”"): 

п_ацто. зе{Тех{Оата(\уа); // тезт1пд 

п_аито. зе опобата( 79); // 1ез11п9 

// мег1Ру а1зрафсв 1птегЕасе 

// {125ЕЕСВ2-7340-49Е0-9567-ЕЕ44877Е0Е2С} 

фат1с сопзф ТТО ТТО_ТЕх2З6Аито = 
{ 0х125РЕСВ2, 0х7340, 0х49ЕО, { 0х95, 0хС7, ОхЕЕ 

0х44, 0хВ7, Ох7Е, ОхОЕ, 0х2С } } 

ЕРОТУРАТСН р; 

НВЕЗИЕТ Пг = т_аито.т_1р01зрафсн->ОиегуТптегРасе (ТТО_ТЕх2ЗьАито, 

(\019**) &р); 
ТВАСЕ( "Оп01101е1оад - ОцегуТптегтасе гези1{ = %х\п", пг) 
р->Не1еазе(); 
} 
у014 СЕх2За\1ем: : ОпИрдате011о1е[оа9(ССтаиТ *+рбтаит) 
{ 
рСтаит->Епаб1е(п_аио.м_1р01зрафсв == МЕ): 
} 
\019 СЕх2За\М1ем: : 0п01101е\п1оаа() 
{ 
т_ацто. Ве1еазе01зрафсй(); 
} 
у01а СЕх2за\1ем: :ОпИрдае01101е\п1оа9(ССтайт *рсиаит) 
{ 
рСтат->Епаб1е(т_аифо.тм_1р01зратсй != М) 
} 


Класс контроллера для Ех23с.ехе 


Ниже показаны заголовки классов СЕх23с и [А4йатт, управляющих компонентом 
Ашотаноп Ех25с. 
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Особый интерес для нас представляет функция-член СЕх23с::Стежмеатт из 
Сюоскриуег.срр. Ее можно вызывать только после создания объекта (документа) 
«будильник». Она заставляет компонент Ех23с создать объект «сигнал» и возвра- 
щает указатель на Пбрась со счетчиком ссылок, равным 1. Функция СОерёрась- 
Ртег:АНасЬГврейсь подсоединяет этот указатель к клиентскому объекту т_@атт, 
но если у этого объекта уже есть диспетчерский указатель, то он освобождается. 
Именно поэтому вы видите в окне отладки, что старый экземпляр Ех23с завер- 
шается сразу же после запроса нового. Протестировать подобное поведение с 
контроллером Ехсе! нельзя, так как Ех234 отключает в своем меню команду Гоа4 
после запуска компонента «будильник». 

В классе «вид» две переменных-члена: т_сосё и т_фатт. Вот как выглядят 
обработчики команд из этого класса: 


\0149 СЕХ2ЗЧ\1ем: : ОпС]оско1еСгеа+еа1агт() 
{ 
СА] агт01а109 919; 
1! (919.00Мода1() == ТООК) { 
С01ебатет1те 9*(2002, 12, 23, 919.м_пНоиг$, 919.т_пМапитез, 
919.т_п5есопа$); 
ЕРОТЗРАТСН рА1агт = м_с1оск. СгеатеА1агт( 4+): 
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т_а1агм. Асфасй01$рафси(рА1агт); // ге1еазез рг1ог оБ]ес*! 
п_с1оск. Веггезв\1п(); 


} 
} 
у019 СЕх2За\1ем: : Оп/рдатеС1оско1еСгеатеа1агт( ССтауТ *«рбтаут) 
{ 
рСтаут->Епаб1е(м_с1оск.м_1ро1зратсй != МИ); 
} 
\019 СЕх2За\1ем: :ОпС1оско1еГоаа() 
{ 


1 (!п_с1оск. Сгеате01зратсв( "Ех23с. Воситепт”)) { 
АГхМеззадеВох( "Ех23с.Ооситеп{ сотропепЕ пое Роипа”) 
гетигп; 

} 

т_с1оск. ри _Р1д9иге(0, С01е\агтап(”“ХТтТ”)): 

м_с1оск. ри{_Р1д9иге(1, С01е\аглапе(“ТТТ”)); 

т_с1оск. ри _Е19иге(2, С01е\аг1апе(“\УТ”)); 
т_с1оск. ри{_Е19иге(3, С01е\аглап(“ТХ”)); 
ОпС]оско1еде{гезпт1те() 
т_с1оск. помп (); 
} 
\0149 СЕх2За\1ем: :Оп/рдатеС1оско1егоаа (ССтаут *рбтаит) 
{ 

рстаут->Епаб1е(м_с1оск.м_1ро1зрафсй == МУ): 


} 

\у019 СЕх2За\М1ем: :ОпС1оско1евегезпЕ1те() 

{ 
СО1ебатеТ1те пом = С01ебафеТ1те: : бетСиггепТ1мте(); 
т_с1оск. зетТ1те (пом); 
п_с1оск. НеРгезйм1т(); 

} 


\019 СЕхаЗа\1ем: :Оп/рдатеС1оско1еНегези1те(ССмаиТ *рбСмаит) 
{ 
рстаут->Епаб1е(м_с1оск.м_1ро1зрафси != МИ): 


о СЕх2За\1ем: :ОпС1оско1е/п1оаа() 

т_с1оск. Ве]еазе01зратсй( ); 

ет СЕх2За\1ем: :ОпИрдатеС1оско1е/п1оа9(ССмайт *рСмаит) 
рСтаит->Епаб1е(м_с1оск.м_1ро1зратсй != МИ): 

} 


Управление приложением МсгозоН Ехсе! 


Программа Ех234 содержит код, который, загрузив Ехсе! и создав рабочую книгу, 
читает и изменяет содержимое ячеек активной таблицы. Управление Ехсе! выпол- 
няется так же, как и управление МЕС-компонентом Ащотаноп, но есть ряд осо- 
бенностей, в которых вам нужно разобраться. 
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Изучая Ехсе! УВА, вы обнаружите, что в программе можно задействовать свы- 
ше сотни различных «объектов». Все они доступны через АиютаНов, но при на- 
писании котроллера автоматизации на МЕС надо знать о свойствах и методах этих 
объектов. В идеале у каждого объекта с функциями-членами, вызываемыми по 
диспетчерским идентификаторам, должен быть свой класс С++. 

У Ехсе! есть собственная библиотека типов, зарегистрированная в реестре. Ааа 
С1а5$ Егот Турейь УЛгага способен считывать этот файл (так же, как и ТТВ-фай- 
лы) и создавать на его основе классы С++ контроллеров для отдельных объектов 
Ехсе!. Поэтому имеет смысл отобрать нужные объекты и свести полученные классы 
в отдельный набор файлов (рис. 23-6). 


АЧЧ С1а5$ Егопл ТурейЬ Уйгак4 - 6234 


'у\есоте то {Пе АЧЯ С!а5$ Егот Турейь УИгаг4 , 
ТЬБ уеаг4 а44$ Чаззез ко уоиг ргодесЕ Базед оп пЕеасез заесе4 Нот а Куре №гагу, МН 


Рис. 23-6. Ада С/а5; Егот Турейь ага способен создавать классы С++ 
для объектов Ехсе,, перечисленных в библиотеке типов Ехсей 


Не исключено, что сгенерированный код придется редактировать вручную в 
соответствии со своими потребностями. Рассмотрим это на примере. Сформировав 
с помощью Ааа С1а5$ Егота Турень УЛ гага класс контроллера для объекта \огК$Вее, 
вы получите такую функцию-член ве Капве: 


ЕРОТЗРАТСН дет_Вапде(УААТАМТ Се111, \УАНТАМТ Се112) 
{ 
[РОТЗРАТСН гези1т; 
зфаф1с ВУТЕ рагт$[] = \Т$_\МАВТАМТ \УТЗ_\АВТАМТ : 
ТпуокеНе1рег(0хс5, ОТЗРАТСН_РВОРЕВТУСЕТ, УТ_ОТЗРАТСН 
(\0149*)&гези1{, рагмз, &Се111, &Се112); 
гефигп гези1{; 


Как известно из документации по Ехсе! УВА, этот метод можно вызывать как 
для одной ячейки (один параметр), так и для прямоугольной области, определяе- 
мой двумя ячейками (два параметра). Вспомните: в вызове /ировеНеретг можно не 
передавать необязательные параметры. В данном случае можно добавить вторую 
перегруженную функцию де! Капсе с одним параметром-ячейкой: 


ЕРОТЗРАТСН де{_Вапде( \УАВТАМТ Се111) // Добавлено 
{ 


ГЛАВА 23 Ащота#оп 549 


[РОТЗРАТСН гези1*; 

эфат1с ВУТЕ рагмз[] = УТЗ_\МААТАМТ; 

ТпуокеНне]рег(0хс5, ОТЗРАТСН_РВОРЕВТУСЕТ, УТ_ОТ5УРАТСН, 
(№\014*)&гези1{, рагмз, &Се111); 

гефигп гези1т; 


— 


Какие же функции подправить? Да те, что вы решили использовать в своей 
программе. Прочтите руководство по Ехсе! УВА, чтобы выяснить обязательные 
параметры и возвращаемые значения. Может быть, кто-то скоро напишет набор 
контроллерных классов на С++ для Ехсе!. 

Объекты Ехсе|, используемые программой Ех234, и соответствующие им классы 
описаны в таблице. (Код содержится в файлах САррИсайоп.Ь, СКапое.в, СУ/огКк$Веесв, 
С\огК$Вее(5.В и С\/огКБоокК$.В.) 


Класс Переменная-член класса «вид» 
сАррисаноп т арр 

СКапве т тапве[ 5] 

С\отЕ5рее т_шотвзрее 

СУ\ОТЕБооЕ$ т_шотерооЕ$ 

СУотерее5 т_шотвзрее5 


Команду Гоа меню Ехсе! Сотр в примере обрабатывает функция-член ОпЕхсе!- 
оеГоа4 класса «вид». Эта функция должна работать, даже если Ехсе| уже запущен 
пользователем. СОМ-функция СесйоеОес! пытается возвратить указатель на 
Откпоит для Ехсе!. СеАсйоеОБуес! требует идентификатор класса, поэтому мы 
сначала вызываем (С/5П2ЕтотРгоШ. Если вызов СеАсниеОБес! успешен, вызыва- 
ется Омегитет/асе, чтобы получить указатель на /ОёбресЬ, который передается 
контроллерному объекту 7_арр класса Аррйсайоп. Если же вызов СеАсноеОБес! 
закончился неудачей, вызывается СОеБреаюсЬОтоет::СтешеррецсЬ, как было с 
другими компонентами. 


\014 СЕх2За\1ем: :ОпЕхсе1о1еЁоа4() 
{ // если Ехсе1 уже запущен, подключаемся к нему; нет - запускаем его 
ЕРОТЗРАТСН р015$р; 
ЁРУМКМОММ рУпк; 
СТО с1$19; 
ТВАСЕ ( "Епфег1пд СЕх2За\1ем: : ОпЕхсе11оад\п"); 
Вед1пМа1Сигзог(); 
// Используем Ехсе1.Арр11сат1оп.9 в ОРЕ1се 2000 
// Используем Ехсе]1. Арр11са{1оп. 10 в ОРР1се ХР 
: : СЕЗТОРГОПРГго9ТО( 1" Ехсе1.Арр11са{1оп. 10", 8с1$19); // из реестра 
1Е(: : бетАст1уе06]ест(с1$19, МЕ, &рупк) == $_ОК) { 
\УЕВТЕУ (рУупк->ОцегуТитегРасе(ТТ0_ТО1зрафсй, 
(\014**) &р01$зр) == $_0К); 
т_арр. АЕТасп01$ратсп(р01$р); 
рУпк->Не1еазе(); 
ТВАСЕ(” а%Тасй сотр1ете\п”): 
} 
е1зе { 


19—2064 
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11 (!п_арр. Сгеате01зратсп( "Ехсе1.. Арр11са{1оп. 10") { 
АРхМеззадеВох ( “М1сгозот{ Ехсе1 ргодгам по Роипа”); 
| Ь 
ТВАСЕ(” сгеафе сотр1ете\п”); 
} 
Епа\Ма1Сигзог(); 


Главная задача ОпЕхседеЕхесше — функции-обработчика команды Ехесще в 
меню Ехсе! Сотр — найти основное окно Ехсе! и сделать его активным (вывести 
на передний план). Для этого придется писать свой УЛп4о\5-код — соответству- 
ющего метода у Ехсе! нет. Мы должны создать и рабочую книгу, если на данный 
момент ни одна не открыта. 

Значения, возвращаемые методами, надо тщательно отслеживать, Например, 
метод АЯ набора Уотёоой$ возвращает указатель на ёбресЬ для объекта ооо 
и, естественно, увеличивает счетчик ссылок. Если б мы сгенерировали класс для 
УотЕБооЕ, то могли бы вызвать АйасрОбреср, чтобы при уничтожении этого объек- 
та вызывалась Ке/еа5е. Но поскольку класс УотЁфоой нам не нужен, мы сами осво- 
бождаем указатель в конце функции. Если же вы забудете освободить указатели, 
отладочная версия МЕС сообщит об утечке памяти. 

В остальной части функции ОпЕхсеюеЕхесше осуществляется доступ к ячей- 
кам рабочей таблицы. Здесь вы убедитесь, насколько просто считывать и задавать 
числа, даты, строки и формулы. Код С++ очень похож на УВА-код, который мож- 
но было бы написать для той же цели. 


\014 СЕх2За\1ем: : ОпЕхсе101еЕхесите() 
{ 
ЕРОТЗРАТСН рВапде, рмМогкБоок$; 
СМпд»* рмпа = Сипа: : Е1пд\1паом( "ХЕМАТМ", МИЕЕ); 
ТЕ (рмМпд != МЕ) { 
ТВАСЕ(“Ехсе] м1пдом Роипд\п”); 
рмпа9->5 пом пдом( $М _ЗНОММОВМАЕ ); 
рипа->Ирдатем1тдом(); 
рмпа->Вг1пд9\1паомТоТор(); 
} 
т_арр. ри{_ЗпеетзТпМеммМогквоок(1); 


\УЕВТЕУ( рмогкбоокз = т_арр. де{_МогкБоокз()); 
т_могкооок$. АЕфасп01 зратси ( рМогкБоок$) ; 


ЁРОТЗРАТСН рмогкБоок = МИ 
1Р (м могкроокз. дет_СоупЕ() == 0) { 
// Ааа возвращает указатель на Могкроок, 
// но у нас нет класса МогкБоок 
рмогкроок = м_могкбоок$. Ада (С01е\аг1ап{( (зПогт) 0)); // Сохраняем указатель, 
// чтобы освободить позже 
} 
ЕРОТЗРАТСН рмогкзпеет$ = м_арр. де*_Могкзнеет$(); 
АЗЗЕНАТ ( рмогкзпеет$ != №1); 
т_могкзреет$. АЕтаси01 зрафси ( риогкзпеетз); 
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ГРОТЗРАТСН рмогкзпеет = м_могкзпее{з. дет_Т+ет(С01е\агтап( (зпогЕ) 1)): 


п_могкзпее{. АтаспО1 зратсв ( риогкзвеет): 
п_могкзпеет. $е1ест(С01е\аг1апЕ( (зпоге) 0)); 


\/ЕВТРУ(рВапое = м_могкзнее{. дет _Вапде(С01еУагзап*("“А1”), 
С01е\агтап{ ("АЛ"))); 
п_гапде[0]. АЕтасп01 зратсв (рВапде); 


\ЕАТРУ( рВапде = м_могкзпеет. дет_Вапде(С01е\/агтап+("А2”) 
С01е\аглап{("А2"))); 
п_гапде[1]. АЕфаси01 зратсй (рВапде); 


\/ЕВТРУ(рВапое = м_могкзнеет. дет_Вапде(С01е\агзапт+("“АЗ”), 
С01е\аг1апт("АЗ”))); 
‚ М_гапде[2]. АЕфасп01 зратсв (рАапде); 


\УЕВТРУ(рВапде = м_могкзпеет. де*_Вапде(С01е\аг1ап* (“АЗ”), 
С01е\аг1ап{("С5"))) 
т_гапде[3]. АЕфасй01 зрафсй (рВапде); 


\/ЕВТРУ(рВапде = м_могкзпеет{. де{_Вапде (С01е\Уаглап+ (“Аб”), 
С01е\аг1апт("Аб”))); 
п_гапде[4].АЕфасп01 зратсв(рВапое); 


п_гапде[4].ри*_\Ма1ие(С01е\/аг1апт(С01ебатеТ1те(2002, 4, 24, 
15, 47, 8))): 

// Получаем сохраненную дату и выводим ее как строку 

С01е\/аг1ап{ уаТ1тебате = п_гапде[4]. де*_\Уа1ие(); 

ТВАСЕ( “гефигпед дафе фуре = %9\п", уатТ1терате. у{): 

С01е\аг1апт уаТетр; 

уаТетр. СпапдеТуре(УТ_ВЗТВ, &\аТ1терате); 

(С5г1п9 $1г(маТетр. 531 г\а1): 

ТВАСЕ( “дате = %3\п”, (сопзф спаг*) з1г) 


п_гапде[0].ри*_\а1ие(С01е\аг1апт("фезе з1г1п9”)); 


С01е\/аг1ап{ уаВези110 = п_гапде[0]. де*_\Ма1ие(); 
1Р (уаВези1{0. уф == \УТ_ВУТВ) { 

(С54г1п9 з1г(уаНези1{0. 6$4г\а1 ); 

ТВАСЕ( “уаВези110 = %$\п”", (сопзф спаг») $1г); 
} 
т_гапде[1].рит_\Ма1ие(Со1е\аг1апт(3.14159)) 


СО1е\/аг1ап{ уаВези1{1 = п_гапде[1]. де*_\Ма1ие(); 
17 (уаНези1{1. уе == УТ_В8) { 

ТВАСЕ( “уаВези1{1 = %Р\п”, уаВези1{1. 961\а1): 
} 
п_гапде[2]. ри _Рогти1а(С01е\аг1апт("=$А?*2.0")); 


С01е\/аг1ап{ уаВези112 = м_гапде[2]. де+_\а1ие(): 
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1Е (\/аАези112. м == УТ_В8) 4 
ТВАСЕ( “уаВези1+2 = %Р\п”, уаВези1{2. 961\а1); 
} 
С01е\аг1ап{ уаВези1{2а = т_гапде[2].дет_Рогми1а(); 
1 (уаАези112а.мЕ == \УТ_ВЗТН) {4 
С51г1п9 з1г(уаВези1{2а. 6$1г\а1 ); 
ТВАСЕ( “уаВези112а = %з\п”, (сопзф спаг») $1г) 
} 
т_гапде[3].Е1118191*(); 
п_гапое[3].Е11100мп(); 
// очистка 
ТЕ (рмМогкБоок != МЕ) { 
рмогкроок->Ве1еазе(); 
} 


Пример Ех23е: клиент Ащотайоп 


Эта программа использует директиву #йпрот для генерации зтац-указателей. Ведет 
себя она практически так же, как и Ех234, разве что не запускает Ехсе!. Директи- 
ву #йпро" мы поместим в файл 5АЁХ.В, чтобы компилятор не создавал управля- 
ющие классы несколько раз. Вот какой код нужно добавить: 


#11с1и4е <аРха1зр.п> 
#1троге ”..\Ех2За\Бебид\Ех2За. 116” гепате_памезрасе( "ВапКОг1\”) 
($119 патезрасе ВапкОг1м\; 


#1трогЕ “..\Ех236\бебид\Ех236.116” гепаме. патезрасе( “Ех23Ь0г1\”") 
($119 патезрасе Ех2360г1м; 


#1трогЕ ”..\Ех23с\берид\Ех23с. 116” гепаме_патезрасе( "С1оскОг1 м") 
($119 патезрасе С1оскОг1м; 


Если в МЕС АррИсаНоп У/Л2ага установлен флажок АсиуеХ сопиго!з, мастер со- 
здаст вызов АхОемй в функции-члене ийтяапсе класса приложения (иначе это 
придется сделать вручную). 

Заголовочный файл класса «вид» содержит такие встроенные зтап-указатели 


ТЕХ2ЗЬАитоРЕг т_аито; 
ТВапкРЕг м_бапк 
ТЕх2ЗсРЕг м_с10оск; 
ТА]1агтРфг м_а1агт; 


А вот код обработчиков команд меню в классе «вид»: 


\0149 СЕх2Зе\1ем: :ОпВапко1еЁоа4() 
{ 
11 (т_бапк. СгеафеТпзТапсе(__ии1д9о{(Вапк)) != $_ОК) { 
АРхМеззадеВох( “Вапк сотропепт поф Роипа”) 
гефигп; 


ГЛАВА 23 АшотаНоп 


уо19 СЕх2Зе\1ем: :ОпИрдатевапко1е!оад (ССмаит *рСмаит) 
{ 

рСтаиТ->Епаб1е(т_рапк. бетТпегРасер+г() == МЕ) 
} 


у0149 СЕх2Зе\1ем: :ОпВапко1еТез+() 
{ 
гу { 
п_Бапк->0ероз11(20.0); 
п_Бапк->\1{п9гама1 (15.0) 
ТВАСЕ( “пем ба1апсе = %Ё\п”, п_бапк->бе{Ва1апсе()); 
} сафсп(_сот_еггог& е) { 
АРхМеззадеВох(е. ЕггогМеззаде()); 
} 
} 
у014 СЕх2Зе\1ем: :Оп/рдатеВапко1еТез{(ССмаит *ромацт) 
{ 
рСтаиТ->Епаб1е (т_бапк. бетТптегРасеР+г() != МЕ); 
} 
у014 СЕх2Зе\1ем: :ОпВапко1е/п1оаа() 
{ 
т_Бапк. Ве1еазе(); 
} 
у019 СЕх2Зе\1ем: :Оп/рдатеВапко1е/п1оаа (ССтаит *рСмацт) 
{ 
рСтаиТ->Епаб1е (т_рапк. бетТитегРасеРЕг() 1= МЕ): 
} 
у019 СЕх2Зе\1ем: :ОпС1оско1еСгеаеа1агт() 
{ 
СА1агт019 919; 
Тгу { 
М (919.00Мода1() == ТООК) { 
С01ебафеТ1те 4*(2001, 12, 23, 919. т_пНоиг$, 
919. п_пМ1питез, 919.м_пбесопа$); 
ЕРОТЗРАТСН рА1агт = т_с10оск->СгеафеА1агт( а*); 
п_а1агт. АЕтасп( (ТА1агм») рА1агт); // ге1еазез рг1ог об] ест! 
т_с1оск->Вегезпи1т(): 
} 
} сажсп(_сот_еггог& е) { 
АГхМеззадеВох(е.ЕггогМеззаде()): 
} 
} 
\019 СЕх2Зе\1ем: :ОпИрдатеС1оско1еСгеаеа1агт( ССиаит *«ротацт) 
{ 
рСтаит->Епаб1е(т_с1оск. бетТптегРасеР\г() 1= МЕ); 
} 
уо1а СЕх2Зе\1ем: : ОпС1оско1еоад() 
{ 
17 (т_с1оск. СгеатеТизтапсе (__ии1д9от(СЕх23сос)) 1= $_0К) { 
АГхМеззадеВох( "СЛоск сотропепе по{ Гоипа”): 
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гетигп; 
} 
{гу { 
т_с1оск->Ри{Е1диге(0, С01е\аглап*(“ХТТ”)) 
т_с1оск->Ри{Е19иге(1, СО1е\аг1апт(“ТТТ”)); 
т_с10ск->Ри{Е19иге(2, С01е\аг1ап{(“\УТ”)); 
т_с10ск->Ри{Р1диге(3, С01е\аг1апт(“1Х")); 
ОпС1оско1еВе!гези{1те(); 
тм_с1оск->5помма п ( ); 
} сатсп(_сот_еггог& е) { 
АТхМеззадеВох(е. ЕггогМеззаде()); 
} 
} 
\019 СЕх2Зе\1ем: :Оп/рдатеС1оско1егоаа9 (ССтаит *«рСтацт) 
{ 
рСмаут->Епаб1е (м_с1оск. бетТптегРасеРЕг() == МЕ); 
} 
\019 СЕх2Зе\1ем: :ОпС1оско1еВеггезй{1мте() 
{ 
С01ебатеТ1ме пом = С01ебатеТ1ме: :бетСиггеп*Т1те(); 
{гу { 
т_с10оск->Ри{Т1ме (пом); 
м_с10оск->Негези\1т(); 
} сатсп(_сот_еггог& е) { 
АРхМеззадеВох(е. ЕггогМеззаде()); 
} 
} 
\0149 СЕх2Зе\1ем: : Оп/рдатеС1оско1еВе{гезн1те(ССтаиТ *«рСтдит) 
{ 
рСтаиТ->Епаб1е(м_с1оск. бетТптегРасеРтг() != МЕ); 
} 
\0149 СЕх2Зе\1ем: :ОпС1оско1е/п1оаа() 
{ 
т_с1оск. Не1еазе(); 
} 
\019 СЕх2Зе\1ем: :Оп/рдатеС1оско1е/п1оа9(ССмауТ *рбСмаут) 
{ 
рСтаут->ЕпаБ1е(м_с1оск. бе{ТптегРасеРг() != МЕ); 
} 
\019 СЕх2Зе\1ем: :0п01101ебетдата() 
{ 
гу { 
т_аифо->01$р1ау01а109(); 
С01е\аг1ап{ мабафа = п_аицфо->бетТех{Оата(); 
АЗЗЕВТ (мабата. у == УТ_ВУТН); 
С51г1п9 зЕгТех{Вата(уабата. 651 г\а1); 
1019 1Оата = м_аифо->бе{опдбата(); 
ТВАСЕ ( “СЕх2За\1ем: : 0п01101ебетдата-1о0пд = %149, Техе = %$\п" 
]1бата, э+гТехЕОата); 
} сатсп(_сот_еггог& е) { 
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АтхМеззадеВох(е. ЕггогМеззаде()); 

} 
} 
\019 СЕх2Зе\1ем:; :Оп/рдате011о1ебетдата(ССмаиТ *рСтаит) 
{ 

рСмаит->Епаб1е(т_аито. бетТптегРасеРег() != МЕ): 
} 
\у019 СЕх2Зе\1ем: :0п01101еЁоаа() 
{ 

1 (т_аито. СгеафеТпзтапсе (__ии19от(Ех2ЗЬАито)) != $_ОК) { 
АГхМеззадеВох ( "Ех2ЗБАифо сотропепе поф Роипа”): 
гефигп; 

} 

ТЕх2ЗоАифо» рЕх2ЗБАито = 0; 

п_ацто. иегуТптегРасе (__ии19от(ТЕх2З6Аито), (\014**)&рЕх2ЗьАито): 

1 (рЕх2ЗБАиТо) { 
рЕх2З6Аифо->Ри{Гопабата(42); 
рЕх2ЗьАифо->Ве1еазе(); 


} 
у019 СЕх2Зе\1ем: : Оп/рдате011о1еоаа(ССтаиТ *рбтацт) 
{ 

рСтаит->Епаб1е (т_аито. бе{Тп+егРасеР+г() == МЕ) 
} 
\019 СЕх2Зе\1ем: :0п01101е\/п1оаа() 


{ 

п_аифо. Ве]1еазе(); 
} 
\014 СЕх2Зе\1ем: : Оп/рда{е01101е/п1оаа(ССмауТ *рбСмаит) 
{ 

рсмаут->Епаб1е(т_аито. бетТптегРасеРег() != МЕ); 
} 


Обратите внимание на блоки #’/саср в функциях, которые работают с ком- 
понентами. Они особенно нужны для обработки ошибок, возникающих при пре- 
кращении работы программы компонента. В примере Ех234 этим занимается МЕС- 
класс СОербресЬО тет. 


Раннее связывание в УВА 


Запуская компоненты Ех23а, Ех23Ь и Ех23с из Ехсе! УВА, вы применяли метод 
позднего связывания (1ие Билате). УВА, обращаясь к какому-то свойству или ме- 
тоду, обычно вызывает /2ёрейсЬ::Сеир$О\атез, чтобы найти диспетчерский иден- 
тификатор по символьному имени. Это не только неэффективно — важнее то, что 
УВА не проверяет типы до фактического обращения к свойству или методу. Пусть 
УВА-программа пытается получить значение свойства, которое она считает чис- 
лом, а компонент вместо этого возвращает строку. В этом случае УВА возвратит 
ошибку периода выполнения, лишь дойдя до оператора Ргорепу Се. 

Однако раннее связывание (вау Ыпа!л®) заставляет УВА предварительно об- 
рабатывать исходный текст программы, преобразуя имена свойств и методов в 
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Р5РШ-идентификаторы до запуска программы компонента. При этом он прове- 
ряет типы свойств, возвращаемых значений и параметров методов, возвращая при 
необходимости ошибки компиляции. Но откуда УВА берет нужную информацию? 
Конечно же, из библиотеки типов компонента, благодаря которой УВА позволя- 
ет программисту просматривать описания свойств и методов сервера. УВА счи- 
тывает библиотеку типов еще до загрузки компонентной программы. 


Регистрация библиотеки типов 


Вы уже видели, что У15а! ЗАю МЕТ генерирует ТГВ-файл для каждого компо- 
нента. Чтобы УВА нашел библиотеку типов, ее адрес должен присутствовать в 
реестре. Записи в разделе ТурейЬ используются браузерами библиотек, а записи 
в разделе Имейасе служат для проверки типов в период выполнения и (в случае 
ЕХЕ-компонента) в процессе маршалинга для диспетчерского интерфейса. 


Как компонент регистрирует свою библиотеку типов 


Выполняясь в автономном режиме, ЕХЕ-компонент может вызывать функцию 
АрхКеяяетТуреь для внесения нужных записей в реестр. Например, так: 


\/ЕВТРУ(АГхО1еАед15егТуреЕ 16 (АРхбетТизтапсеНапа1е(), +пеТуреезьвито, 
лЕхаЗЬ: 16"); 


Здесь ФеТурейьСИЛО — статическая переменная типа СОЛО. 


// {А95ЛБАСА-5885-1100-848Е-004005263058} 
$фаф1с сопзф @ТО тпетуреезьвитв = 
{ 0ха9515аса, 0х5685, 0х1140, { 0х84, 0х8+, 0х00, 0х40, 0х05, 0х26, 
0х30, 0х5ь } }; 


Функция АхКеяяетТуреьЬ объявлена в файле аЁхулп.В, который требует опре- 
деления макроса _АЕХРИМ. Таким образом, эту функцию нельзя использовать в 
обычной РЦ, если только вы не скопируете ее код из исходных файлов МЕС. 


1ОЕ-файл 
Теперь самое время обратиться к ШТ-файлу того же проекта: 


// Ех23Ь.191 : Туре 116гагу зоигсе Рог Ех236. 911 
// ТП13 111е м111 Бе ргосеззед Бу {Ве МТОЕ сотр11ег фо ргодисе 1пе 
// туре 116гагу (Ех23Ь. 116) 


#1пс1и4е “о1ес1. п” 
[ чи19(ЕЕ560С40-В710-4543-8841-809627А0А504), \уегз10п(1:0) ] 
]116гагу Ех236 
{ 
1рог{116("5${901е32.+16”); 
1трог{116("31901е2.116"); 
// Рг1тагу д1зрафсй 1п%егФасе Гог Ех23ЗБАито 


[ чи19(125РЕСВ2-7340-49Е0-95С7-ЕЕ44877ЕОЕ2С) ] 
915рапфеггасе ТЕх2ЗЬАито 
{ 
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ргорегЕ1ез: 
[19(1), не1рз{г1п9(“ргорегёу Еопдбата")] ЕО№ Ёопдраха; 
[19(2), пе1рзг1п9(“ргорегфу ТехОата”)] \УАВТАМТ Тех{Вата; 
пметпо0$: 
[19(3), пе1рз{г1п9("тефпоя 01$р1ау01а109”)] 
\УАВТАМТ_ВООЕ 01$р1ау01а109(\019); 

} 

// С1азз 1пРогта{1оп Рог Ех2ЗБАифо 

[ цчи19(ВАЕЗО9ЕО-4518-43СА-В017-2ЕВАЗЗ2СВ618) ] 

с0с1а$з Ех2ЗБАито 

{ 
[9еРаи1{] 91зраптегРасе ТЕх2ЗЬАито; 

}; 


— 


Как видите, между реестром, библиотекой типов, компонентом и клиентом УВА 
существует множество связей. 


Примечание Полезная утилита ОТЕУТЕХ/ из состава У15ца1 С++ позволяет про- 
сматривать зарегистрированные компоненты и их библиотеки типов. 


Использование библиотеки типов в Ехсе! 
Последовательность операций, выполняемых Ехсе! для того, чтобы задействовать 
вашу библиотеку типов, такова. 


1. При запуске Ехсе! считывает из реестра раздел Турешь и составляет список всех 
библиотек типов. Он загружает библиотеку типов УВА и библиотеку объектов 
Ехсе]. 


ыы 


Пользователь (или автор рабочей книги) после запуска Ехсе|, загрузки рабо- 
чей книги и переключения в окно редактора У15ча! Ваяс Еайог выбирает в меню 
Тоо!5 команду ВеЁегепсез и отмечает флажок в строке Ех235; как показано на 
рисунке. При сохранении рабочей книги информация о ссылках сохраняется 
вместе с ней. 


ЕхрезпеВеро"Сеге 1.0 Туре ИБгагу 
ЕхроиЕ 1.0 Туре ИБгагу 
ЕхрогМодейег 1.0 Туре ИЬгагу 


Гахадти 1.0 Туре ИБгагу 
Гахсот 1,0 Туре МЬгагу 
ЕОае 1.0 Туре МБгагу 
РЩЕМСМТ 1.0 Туре Цбгагу 
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3. 


4. 


Теперь пользователь Ехсе! может просматривать свойства и методы Ех23Ь, 
выбрав в меню У1еуу команду ОБесе Вго\’5ег: 


Мегозой Ува! Ваяю — Ен? ое Веомсег 


УВАРГодесЕ (Ек23ЗЬ.н15) 
ых Мстозой: дес5 


Оизриаубаоа 
Гопобайа 
Тедоаа 


$85 ЕиертаюдЕШег 

$8) ЕнертаодЕЩегз 

383 ЕиергаюдЗе!ес!еди" 
{$$$ ЕИеЗеагсн 


Чтобы ваша программа использовала библиотеку типов, просто замените строку 
01т 011Сотр Аз ОБ)есе 

на: 
01т 011Сотр Аз ТЕх2ЗЬАито 


Программа на УВА сразу завершится, если не найдет /Ех23ЬАшю в списке 
ссылок. 
Выполнив оператор СгеаеОБесЕ и загрузив компонент, УВА вызовет Оиегущет- 
Ласе для ПО_ЛЕх2ЗЬАшо, определенного в реестре, библиотеке типов и таблице 
интерфейсов класса компонента. (На самом деле /Ех23ЬАию является интер- 
фейсом Шёрась.) Это делается для большей безопасности. Если компонент не 
сможет предоставить этот интерфейс, программа на УВА завершится. Теоре- 
тически Ехсе! мог бы применить для загрузки СТ$Ш из библиотеки типов, но 
он использует СГ из реестра, как и в режиме позднего связывания. 


Зачем нужно раннее связывание 


Вы, наверное, подумали, что раннее связывание ускорит работу компонента Ашо- 
тацоп. Но скорее всего вы не заметите этого из-за «узкого места» — вызовов [0 &- 
рейс: Чпооке. Типичное обращение клиента С++ к МЕС-функции /иооЁе в компо- 
ненте С++ занимает около 0,5 мс, что совсем немало. 


Возможность просмотра, предоставляемая библиотекой типов, вероятно, важнее, 


чем связывание на этапе компиляции. Если вы пишете контроллер на С++, биб- 
лиотеку типов можно загружать через разные ОГЕ-функции, в том числе Гоа Туре- 
АБ, после чего она становится доступна через интерфейсы ГРурейь и ГТуретр. Но 
не рассчитывайте разделаться с проектом за пять минут — интерфейсы библио- 
теки типов весьма сложны, и с ними придется повозиться. 
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Повышение скорости связи контроллер-компонент 


Мисгозой признает ограничения интерфейса Шёреср. Он медлителен по приро- 
де, потому что все данные пропускаются через переменные типа УАЮМАМТ и зача- 
стую преобразуются на обоих концах (на контроллере и в компоненте). Сейчас 
появилась новая его разновидность — двойственный интерфейс (Чиа! шие!асе), 
при работе с которым вы определяете собственный интерфейс, производный от 
Шбрайсь. В него включаются не только Гигое и Сейр$Ой\атез, но и новые функ- 
ции. Если клиент достаточно «сообразителен», он обойдет неэффективный ГигоЁе 
и вместо него вызовет специализированные функции. Двойственные интерфей- 
сы могут поддерживать либо только стандартные типы данных АщотаНоп, либо 
произвольные типы'. [Обсуждение двойственных интерфейсов выходит за рамки 
этой книги — см. «тяае ОГЕ 2» (М!сгозоЁ Рге$$, 1995, Зесопа Е@юоп) Крейга Брок- 
шмидта (Кга1? Вгоск$сЬпа0.] 

Прямая поддержка двойственных интерфейсов в каркасе МЕС среды У150а1 С++ 
„МЕТ не предусмотрена, но пример АСРОАГ, поставляемый с У1зиа| С++, поможет 
получить первое представление о них. 


' К методам и свойствам двойственного интерфейса можно обращаться либо через 


Шбрейср:1пооке, либо через угаЫе. В последнем случае вызов выполняется быстрее. 
Однако типы данных, поддерживаемые двойственным интерфейсом, ограничены 
типами данных АиотаНоп. — Прим. перев. 


ГЛАВА 


24 


Шпкогт ба Тгапз{ег: буфер. 
обмена и операция ОЁЕ 
агад-апа-агор 


В технологии СОМ заложен мощный механизм обмена данными как внутри УЙп- 
Чоу’5-приложений, так и между приложениями. Он называется ОпИогт Ра{а ТгапзЁег 
(унифицированная передача данных), или ОПТ. Как вы увидите, ОПТ обеспечи- 
вает все виды форматирования и хранения передаваемых данных, выходя далеко 
за рамки стандартной передачи данных через буфер обмена. Ключевой элемент 
механизма ОПТ в СОМ — интерфейс ДамОвуеси. 

МЕС тоже поддерживает ОПТ, но не в такой степени, чтобы скрыть все, что 
происходит на уровне СОМ-интерфейсов. Одно из полезных применений унифи- 
цированной передачи данных — операция @газ-ап4-агор («перетащить и отпус- 
тить»). Многие разработчики реализуют ее в приложениях как один из стандарт- 
ных способов обмена информацией. Библиотека МЕС тоже поддерживает опера- 
цию Чга8-апа-агор, которая — вместе с передачей данных через буфер обмена — 
является основной темой этой главы. 


Интерфейс Ра аОЩес: 


Интерфейс РеяОБес! применяется при передаче данных не только через буфер 
обмена и операцией Чга-ап4-агор, но и в составных документах, АсНуеХ-элементах 
и специализированных средствах ОГЕ. В книге «шп51аАе ОГЕ» (М!сгозой Ргезз, 1995, 
бесопа Е@оп) Брокшмидт советует: «Рассматривайте объекты как крошечные 
пакеты данных». Так вот, интерфейс ДеаОБес! помогает перемещать эти пакеты 
независимо от их содержимого. 
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Программируя на уровне \Лп32 АР!, вы написали бы класс С++ для поддержки 
ШРаяОБеа. Затем ваша программа создала бы обжекты данных (Чага оБ}есг$) этого 
класса, и вы обращались бы к ним через функции-члены /ДамОБуес!. В этой главе 
вы узнаете, как достичь того же результата, используя МЕС-реализацию /ДеаОБ7ес. 
Но сначала выясним, чем ОГЕ-буфер лучше обычного буфер обмена УХЛп4Чо\5. 


Преимущества /ра{аОБес! в сравнении 
со стандартной поддержкой буфера обмена 


МЕС никогда особо не поддерживала буфер обмена УЛпао\з. Если вам уже при- 
ходилось работать с ним, вы наверняка вызывали \/1152-функции ОрепСИрбоата, 
С1озесирьоата, сасйрьоата риа и 5есирьоатаБша. Одна программа копирует 
данные в буфер обмена в определенном формате, а другая выбирает их оттуда по 
коду формата и вставляет в свой документ. Стандартные форматы буфера обмена 
включают участки глобальной памяти (определяемые по НОГОВАГ) и СП][-объек- 
ты вроде растровых изображений и метафайлов (определяются их описателями). 
Глобальная память может содержать данные в нестандартных форматах и текст. 

Интерфейс ДейаОБуесЕ дает то, чего не хватает буферу обмена УЛп4оууз. Если 
коротко, то вы передаете или считываете из буфера обмена указатель на /ДеяОЩес, 
а не отдельные данные в каких-то форматах. Объект данных может содержать 
целый массив разных форматов, которые несут информацию об устройстве вы- 
вода, например характеристики принтера, и определять представление данных 
(Чака азресо. Стандартное представление — это сами данные, но есть и другие, 
например, значок или микрокартинка (итЬпа!), отражающая хранимое изоб- 
ражение в уменьшенном виде. , 

Интерфейс РейчОБес! задает носитель объекта данных в конкретном формате. 
Обычная передача через буфер обмена опирается исключительно на использо- 
вание глобальной памяти. С другой стороны, интерфейс [РеаОБес позволяет 
передавать имя дискового файла или указатель на структурированное хранили- 
ще (зигастаге4 з‘огазе). Таким образом, при передаче очень большого объема дан- 
ных, хранящихся в файле на диске, нет нужды тратить время на копирование его 
в оперативную память и обратно. 

Между прочим, указатели (РечОБес совместимы с программами, в которых 
применяются старые способы обмена даннми через буфер обмена. Коды форма- 
тов совпадают. \Лп4о\ууз обеспечивает автоматическое преобразование информа- 
ции в объекты данных, и наоборот. Разумеется, если программа, поддерживаю- 
щая ОГЕ, поместит в объект данных указатель на бютаве и передаст объект в бу- 
фер обмена, старые программы не смогут считать данные в этом формате. 


Структуры РОАМАТЕТС и $ТСМЕВШМ 


Прежде чем приступить к изучению функций-членов /ДейаОБесь, нужно рассмот- 
реть две важные структуры СОМ, используемые в качестве типов параметров: 
ЕОКМАТЕТС и 5ТСОМЕРШЩМ. 
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РОНМАТЕТС 


Эту структуру часто используют вместо формата буфера обмена для описания 
формата данных. В отличие от формата буфера она содержит информацию об 
устройстве вывода, представлении и носителе данных. Поля структуры РОКМАТЕТС 
описаны в таблице. 


Тип Имя Описание 


СИРЕОКМАТ СПоттаё Структура, содержащая форматы буфера обмена: стандар- 
тные (например, СЕ_ТЕХТ для текста или СЕ Г/В для сжа- 
тых изображений), нестандартные (например, ВТЕ) и ОТЕ 
(для создания связанных или внедренных объектов). 

РУТАКСЕТРЕИСЕ* р Структура, содержащая информацию об устройстве вы- 


вода данных, в том числе имя драйвера устройства (допу- 
стимое значение — МШ/). 


РУОКР шАзреср Перечисляемая константа типа ОИАЗРЕСТ 

(РУА5РЕСТ СОМТЕМТ, РУАЗРЕСТ_ТНОМВМАЦ, и т. д.) 
[ОМС Ипаех Обычно равно -1. 
рУОко рутеа Определяет носитель, используемый для передачи дан- 


ных (ТУМЕР_НОЮВАЕ, ТУМЕР_ЕИЕ, ТУМЕР)_19ТОКАСЕ и т.д). 


Конкретный объект данных содержит набор элементов ЕОЮМАТЕ ТС, а резовБест 
обеспечивает способ их перечисления. Вот макрос, полезный для заполнения этой 
структуры: 

#деГ1пе ЗЕТРОВМАТЕТС( Те, сР, азр, +9, пед, 11) \ 

((Ге). сгРогмаф=се, \ 

(Ге). @мАзресф=азр, \ 
(Те). рЕ9=а, \ 

(Ге). тутед=теа, \ 
(Ге). 11п4ех=11) 


Структура $ТСМЕБВШИМ 


Другая важная структура, используемая функциями-членами ШРезОБесь, — 5ТСМЕ- 
РОМ, представляющая собой описатель глобальной памяти, используемой в пе- 
редаче данных. Вот поля этой структуры. 


Тип Имя Описание 

——_ы— о 
рУоОкр тутеЯ Определяет носитель; используется при маршалинге 
НВИМАР рВйтар Описатель растрового изображения* 


НМЕТАЕПЕРСТ рМеаЕйеР1с+ Описатель метафайла* 
НЕМНМЕТАЕПЕ РЕПЬМааЕйе Описатель расширенного метафайла* 


НОГОВАЕ 1161612721 Описатель глобальной памяти* 

ГРОГЕ$УТК 1р52ЕйеМате Имя файла на диске (двухбайтовые символы)* 
5ТКЕАМ* рят Указатель на интерфейс /5/теат* 

5ТОКАСЕ* ря Указатель на интерфейс бютаве* 

ИМКМОММ\* РИпкРотКаеа5е Используется клиентами, чтобы вызвать Кееазе для 


форматов с указателями на интерфейсы 


* Это поле является частью объединения (ипюоп), в состав которого входят описатели, строки 


и указатели на интерфейсы, используемого процессом для доступа к передаваемым данным. 
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Как видите, структура 5ТСМЕБРИМ определяет, где хранятся данные. Поле1утей 
сообщает, какой элемент объединения используется. 


Функции-члены интерфейса /)ааОЩес! 


У интерфейса ДеаОБес! девять функций-членов. Все они детально описаны в 
книге Брокшмидта и в МЕС 1Ьгагу Веегепсе. Здесь упомянуты лишь те, что важ- 
ны для понимания материала этой главы. 


НВЕЗУЕТ ЕпитРогмафЕфс(ОМОВО дмО1гест1оп, 
ТЕпитРОВМАТЕТС** ррЕпим); 


Имея указатель на /ДааОБес! для объекта данных, можно вызвать ЕйитЕоттайс 
для перебора всех форматов, поддерживаемых этим объектом. Библиотека МЕС 
изолирует вас от этого уродливого АРТ. Как именно, вы узнаете при рассмотре- 
нии класса СОереазОБес+. 


НАЕЗИЕТ бетбафа(РОВМАТЕТС» рЕЕТп, ЭТСМЕОТИМ» рэтм); 


сеа — самая важная функция интерфейса. Где-то «высоко-высоко в небе- 
сах» находится объект данных, а у вас есть указатель на его интерфейс ДеаОБеси. 
В переменной РОКМАТЕТС вы задаете нужный формат и передаете пустую пере- 
менную 5ТСМЕРШМ для получения результатов. Если объект данных поддержи- 
вает заданный формат, бееа заполняет структуру 5ТСМЕРШМ. В противном 
случае возвращается код ошибки. 


НВЕЗУЕТ ОцегубетВата(РОВМАТЕТС» рЕЕ); 


Эту функцию вызывают, когда не уверены, может ли объект данных предоста- 
вить данные в нужном формате. Код резульгата сообщает «да, могу» (5_ОК) или 
«нет, не могу» (5_ЕА[5Е). Вызов этой функции эффективнее, чем вызов Сейеща. 


НАЕЗУСТ 5е%{Оата(РОВМАТЕТС» рЕЕТп, ЭТСМЕОТОМ» р$ТМ, ВООЕ РВе1еазе): 


Объекты данных редко поддерживают 5ееа. Обычно данные в них загружа- 
ются в серверном модуле, клиенты же выбирают данные вызовом Сееа. Исполь- 
зуя 5ереа, вы передавали бы данные в обратном направлении — все равно, что 
перекачивать воду из дома в водопровод. 


Другие функции-члены /РааОЩес!: консультативная связь 


Этот интерфейс содержит другие важные функции, позволяющие реализовать 
консультативные связи (а4у1зогу соппесноп). Программа, которой нужно полу- 
чать уведомления об изменении данных объекта, передает ему указатель /Адибеб те 
вызовом ДРеаОвуес!::РАдие. Далее объект вызывает функции-члены /Адобе ие, 
реализуемые клиентской программой. Консульгативные связи не нужны для опе- 
рации агаг-ап4-агор. 


Поддержка механизма ЦОТ в МЕС 


В библиотеке МЕС сделано многое, чтобы облегчить программирование объектов 
данных. При изучении МЕС-классов объектов данных вам станет понятен прин- 
цип, по которому построена поддержка СОМ в МЕС. На стороне компонента биб- 
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лиотека обеспечивает базовый класс, реализующий один или несколько интер- 
фейсов ОТЕ. Функции-члены интерфейса вызывают виртуальные функции, кото- 
рые вы переопределяете в производном классе, а на стороне клиента библиотека 
предоставляет класс-оболочку указателя на интерфейс. Вы вызываете простые 
функции-члены, использующие этот указатель для обращения к СОМ. 

Здесь стоит внести ясность в терминологию. Об5ект данных (Ааа оБес®) — 
это настоящий объект С++, создаваемый вами, и именно в этом смысле данный 
термин использует в своей книге Брокшмидт. В документации по МЕС объект дан- 
ных — это то, что клиентское приложение «видит» через указатель на /ДааОвуес. 
Объект, создаваемый программой компонента, называется там источником дан- 
ных (Ааа зоигсе). 


Класс СО/ебаа$оигсе 


Чтобы получить источник данных, вы создаете объект класса СОеБаая5оихсе, ко- 
торый реализует интерфейс ДеаОБуес! (без поддержки уведомлений). Этот класс 
создает и управляет набором форматов данных, хранимым в кэше. Источник дан- 
ных — это обычный СОМ-объект, поддерживающий счетчик ссылок. Обычно вы 
создаете и заполняете источник данных, после чего передаете его в буфер обме- 
на или в функции, реализующие агаэ-ап4-агор, не беспокоясь о его дальнейшей 
судьбе. Если же вы решили не передавать источник данных, можете вызвать его 
деструктор, выполняющий очистку всех форматов. Далее приведены некоторые 
наиболее полезные функции-члены СОерБе$оигсе. 


\014 Сасперата(СЕТРЕОВМАТ стЕогмаф, 
ОТ@МЕОТИМ» 1р5т9Мед1ит, 
РОВМАТЕТС* 1рЕогматЕфс = МЕ); 


Эта функция добавляет элемент к кэшу объекта данных для передачи данных. 
Параметр 12518 Мефит указывает, где находятся данные, а /рЕоттайс описывает 
их. Например, если структура 5ТСМЕРШМ задает имя файла на диске, это имя и 
сохраняется в объекте данных. Если же рЕоттиЕК не задан (т.е. его значение — 
МОГ), функция заполняет структуру ЕОКМАТЕТС значениями по умолчанию. Но 
безопаснее, если вы создадите переменную ЕОКМАТЕТС с установленным значе- 
нием поля рутед. 


014 Саспеб1оба1Оата(СЕТРЕОВМАТ стЕогпах, 
НОЕОВАЕ пб106а1, РОВМАТЕТС» 1рЕогтафЕфс = М); 


Это специализированная версия Сасрериа для размещения данных в глобаль- 
ной памяти (определяемой параметром НОСГОВАГ). Владельцем блока глобальных 
данных становится объект — источник данных, так что вам не надо освобождать 
блок после кэширования. Обычно параметр /рЕоттеиЕг не применяют. Функция 
СасресюраШеиа не создает копию переданных ей данных. 


ОАДОРЕРЕЕСТ Оо0гад0гор(ОМОВО омЕРТест$ = 
ОВОРЕРРЕСТ_СОРУ ! ОВОРЕРРЕСТ_МО\Е ! 
ОВОРЕРРЕСТ_(ТМК, ЕРСВЕСТ 1рВесе5тагОгад = М, 
СО01ебгорЗоигсе» рОгорбоигсе = МЕ): 
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Эта функция вызывается для выполнения операции @газ-ап9-агор; вы увидите 
ее в примере Ех245Ь. 


№019 $е{С11рбоага(\01а); 


Эта функция (см. пример Ех24а), вызывает Ое5есСйрвоата для вставки источ- 
ника данных в буфер обмена УЛпао\з. Буфер обмена отвечает за удаление источ- 
ника данных и тем самым за освобождение глобальной памяти, связанной с фор- 
матами в кэше. Когда вы создаете объект СО/еБжа$оихтсе и вызываете 5есйрвоата, 
СОМ вызывает для объекта АдаКе] 


Класс СОерааОЩес! 


Этот класс (производный от ССтаТатсей) является принимающей стороной в пе- 
редаче данных; его открытая переменная-член 7 _ррОааОвБес указывает на Деа- 
ОБест. Вы должны задать значение этой переменной прежде, чем использовать 
объект. Деструктор класса лишь вызывает Ке/еа$е для указателя на ([РаёчОБесе. Далее 
приведено несколько полезных функций СОереачОвВуесе 


ВОО1 АфтаспС11рбоага(\019); 


Как указывает Брокшмидт, внутренняя обработка буфера обмена в ОГЕ довольно 
сложна. Однако она покажется вам проще, если вызывать функции-члены СОЁР- 
реаОБесе. Сначала создается «пустой» объект СОеречОВуесь, после чего вызы- 
вается функция АНасЬСйрьЬоата, которая обращается к глобальной функции ОеСе!- 
СИрфоата. В результате переменная-член 7и_рБеаОБес! указывает на объект — 
источник данных (так это по крайней мере выглядит), и вы получаете доступ к 
его форматам. 

Вызывая функцию-член Сееа, чтобы получить данные, помните: владелец 
данных — буфер обмена, и вы не можете изменить его содержимое. Если форма- 
том данных является указатель типа НОГОВАЕ, не пытайтесь освобождать эту па- 
мять или запоминать НСГОВАЕ для дальнейшего использования. Если же вам ну- 
жен доступ к данным в глобальной памяти в течение длительного периода, поду- 
майте об использовании Сектора. 

Если данные включены в буфер обмена программой, не поддерживающей СОМ, 
функция АйасрСйрБоата все равно действует, так как СОМ автоматически создает 
объект данных с форматами, соответствующими обычным данным в буфере об- 
мена У/ш4о\. 


\019 Вед1пЕпитРогтат$(); 
ВОО бетМехЕРогмат(РОВМАТЕТС» 1рЕогматЕтс); 


Эти две функции позволяют просматривать в цикле форматы, которые содер- 
жит объект данных. Сначала вызывается ВезтЕпитЕоттеи$, после чего на каждой 
итерации вызывается Сей\ехШоттей, пока не вернет ЕАГЗЕ. 


ВООЕ бетрата(СЕТРЕОВМАТ сРЕогтат, 
ЭТ@МЕОТИМ» 1рофдмед1ит, 
РОВМАТЕТС» 1рЕогтафЕтс = №); 
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Эта функция вызывает ШезОвБес::Сееаа: и более ничего. Если источник дан- 
ных содержит запрашиваемый формат, функция возвращает ТКОЕ. Обычно тре- 
буется указывать параметр ЮЕоттейЕк. 


НСГОВАЕ беЕб1оБа1Вата(СЕТРЕОВМАТ сРЕогтат, 
РОВМАТЕТС» 1рРогтафЕфс = МЕ); 


Вызывайте эту функцию, если запрашиваемый вами формат совместим с гло- 
бальной памятью. Функция копирует блок памяти в указанном формате и возвра- 
щает описатель НСГОВАГ, который вы должны впоследствии освободить. Зачас- 
тую параметр [рЕоттайс можно не указывать. 


ВООЕ ТзБафаАуа11а61е(СЕТРЕОВМАТ стЕогтат, 
РОАМАТЕТС» 1рЕогтафЕфс = МЕ); 


Эта функция проверяет, содержит ли объект данных указанный формат. 


Передача объекта данных через буфер обмена 


Теперь, познакомившись с классами СОереаОВес! и СОерешабоихсе, вы можете 
запросто работать с буфером обмена. Но почему бы не передать данные через буфер 
обмена старым методом — с помощью СесСирьоатариа и 5есйрбоата) ща? Для 
наиболее распространенных форматов это допустимо, но, написав функции, ра- 
ботающие с объектами данных, вы сможете вызвать эти же функции и для под- 
держки операции @газ-ап4-4гор. На рис. 24-1 проиллюстрирована связь между 
буфером обмена и классами СОеБа$оигсе и сОержаОБе“. 


Копирование Вставка 


Переменная-член п7_/рбааОБес 
содержит указатель на /дааОБес! 
объекта СО/еБаа$оигсе 


Саспебобааа 
или Саспераа АнаспС/рьоага 
5еС/рьоага _ 


равзОБес 
о Е Г. (Данные из глобального 
Текст с формати кэша копируются 
рованием (АТЕ)_ в буфер обмена) 


верая 
или аесова/баа 


Рис. 24-1. Обработка ОГЕ-операций с буфером обмена в МЕС 


Программа, копирующая данные, создает объект СОерая$оитсе, кэш которо- 
го заполняется форматами. Потом вызывается 5еСирфоата, и форматы помеща- 
ются в буфер обмена. Программа, вставляющая данные, вызывает аПасьсйрьоата 
для подключения указателя на ДеяОБес! к объекту СОеВреаОвВуесь а затем про- 
изводит выборку отдельных форматов. 
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Допустим, в приложении в архитектуре «документ-вид» у документа есть пе- 
ременная-член 77_51ех! типа СУ тя. Нам нужны функции — обработчики команд 
в классе «вид», которые копируют и вставляют данные из буфера обмена. Прежде 
чем писать эти функции, следует написать две вспомогательные. Первая, багеТелхи, 
создает объект — источник данных на основе содержимого 77_5йТех. Она конст- 
руирует объект СОераа$оихтсе, затем копирует строку в глобальную память и, на- 
конец, вызывает Сасфесораеа, чтобы сохранить в источнике данных описа- 
тель НОГОВАГ. Вот код $авеТехи. 


С01ератазоигсе» СМУ\1ем: : ЗамеТехе() 
{ 
СЕх24100с* р0ос = бе{Восимепт(); 
14 (!р0ос->т_зтгехф. Т$Етрфу()) { 
С01ебафа$оигсе» р5оугсе = пем С01ебафа$оигсе(); 
10 пТех{$12е = бетбоситеп{( )->т_з1гТех{. беЕепоти() + 1 
НСЕОВАЕ ИТехф = : :61оба1А11ос(СМЕМ_ЗНАВЕ, пТех+$17е): 
ЕРУТН рТехЕф = (1РЗТВ) : :@1оба1оск(пТех+е):; 
АЗЗЕНТ (рТехф); 
эЕгпсру(рТехт, бетВоситепт()->т_з1гТехе, 
пТехЕ$17е - 1); 
::610оба1п1оск(НТех*); 
р$оигсе->Саспеб1оба1Вата(СЕ_ТЕХТ, ПТех+):; 
гетигп р5оигсе; 
} 
гефигп МИ 


Вторая вспомогательная функция, РоРаяеТехт, заполняет 7и_$Тех! содержимым 
объекта данных, переданного как параметр. Здесь мы используем СОеБеяОБесе::Се1- 
реа вместо сесобаШеа, так как последняя копирует глобальный блок памяти. 
Это излишне, поскольку мы все равно скопируем текст в объект С5ртв. Исход- 
ный блок памяти мы не освобождаем, потому что он принадлежит объекту дан- 
ных. Вот код ДоРаяеТехЕ 


// Память является перемещаемой, поэтому надо использовать блоба1оск! 
ЗЕТРОВМАТЕТС( Тш+, СЕ_ТЕХТ, ОМАЗРЕСТ_СОМТЕМТ, МЕ, 
ТУМЕО_НО1ОВАЕ, -1); 
\/ЕВТРУ (рбата06]ес+->бетВата(СЕ_ТЕХТ, &$19, &Рт*)); 
НОГОВАЕ ПТехЕ = 519. 161оБа1; 
бе{Обоситеп*()->т_згТехе = (ЕРУТВ) ::61оба1оск(НТех+); 
::61оба1\п1оск(ПТех+); 
гетигп ТВОЕ; 


А вот два обработчика команд: 


\0149 СМу\1ем: :ОпЕд1ЕСору() 
{ 
С01ебафазоигсе* р5Зоигсе = ЗауеТехе(): 
1Е (р5оигсе) { 
рзоигсе->5е1С11рбоага(); 
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} 
\у019 СМу\1ем: : ОпЕд1{Разте() 
{ 
С01ерата06]есЕ датабБ]ес*; 
\ЕВТРУ (дата0Б]ес+. АЕфасвС11рбоага()); 
роРазтеТехт ( &дата06] ест); 
// Освобождаем дафа0ЬЗес+ 


МЕС-класс САесИтгаскКег 


Класс СКесИтасвет полезен для программ как применяющих, так и не применяю- 
щих ОГЕ. Он дает пользователю возможность перемещать прямоугольный объект 
и изменять его размеры в окне представления. В нем есть две важных перемен- 
ных-члена: 77_751/е (определяет рамку объекта, маркеры его масштабирования и 
прочие характеристики) и 771_тес! (содержит аппаратные координаты объекта). 
Рассмотрим наиболее важные функции-члены. 


\019 Огам(С0С* р0б) сопзт; 


Рисует прямоугольник (1таскег), ограничивающий объект, в том числе рамку и 
маркеры масштабирования, но не прорисовывает сам объект. Последнее — ваша 
задача. 


ВООЕ Тгаск(С\Мпа» рмпа, СРо1пе ро1пт, 
ВОО БА11омТпуегЕ = РАЁЗЕ, Сипа* рипас11рТо = МЕ): 


Вызывается в обработчике сообщения М_[ВОТТОМРО\УМ. Если курсор нахо- 
дится на рамке ограничивающего прямоугольника, пользователь может изменять 
размеры последнего, передвигая мышь при нажатой кнопке, а если курсор внут- 
ри прямоугольника — перемещать прямоугольник. Когда курсор оказывается за 
пределами прямоугольника, функция сразу же возвращает ЕА/5Е; в противном случае 
ТгасЁ возвращает ТКОЕ, но только после того, как пользователь отпустит кнопку 
мыши. Таким образом, поведение Т’ас в чем-то схоже с поведением СРщов::Оо- 
Мода. В нее заложена своя логика выборки сообщений. 


11 НаеТезе(СРо1иф ро1пе) сопзт; 


Вызывайте НИ1е5, если вам надо различать нажатия кнопки внутри и за пре- 
делами ограничивающего прямоугольника. Функция сразу возвращает управление 
и сообщает код, определяющий положение указателя мыши относительно прямо- 
угольника. 


ВООЕ бееСигзог(Сипа»* рмпа, ИТМТ пНаеТезе) сопз{; 


Вызывайте ее в обработчике сообщения ИМ_5ЕТСИК$ОК окна представления, 
чтобы изменять форму курсора при перемещении или масштабировании огра- 
ничивающего прямоугольника. Если возвращается ЕА[5Е, вызывайте функцию 
Оп5е!Сигзот из базового класса; а если ТКОЕ, то возвращайте ТКИЕ из своего обра- 
ботчика. 
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Преобразование координат прямоугольника СВесЙтаскКег 


СКесИтгасвег:т_тес! содержит аппаратные координаты. И вам не избежать преоб- 
разований, если вы используете прокрутку в окне представления, изменяете ре- 
жим преобразования координат или смещаете начало координат окна. Общий 
способ решения этой задачи таков. 


1. Определите в своем классе «вид» переменную-член типа СКесИтасвег, напри- 
мер т #гасЁег. 

2. Определите в том же классе отдельную переменную-член для хранения логи- 
ческих координат с именем т тес Итасег. 

3. В функции ОпрОтаи класса «вид» запишите в 7 тес! новые аппаратные коор- 
динаты и нарисуйте ограничивающий прямоугольник. Это позволит скоррек- 
тировать изображение, если с момента предыдущего вызова Ой)гаи окно было 
прокручено. Вот пример кода: 


п_Тгаскег. п_гесф = т_гестТгаскег; 
рос->ЕРфоР (т_фгаскег.т_гест); // нужны аппаратные координаты 
т_Тгаскег. Огам( рос); 


4. В обработчике левой кнопки вызовите Тгаск, сохраните обновленные логичес- 
кие координаты в 77 тесИтгасЁег и вызовите тоайаае: 


11 (т_тгаскег. Тгаск(111$, ро1лпф, РАЁЗЕ, МЬ)) { 
СС11еп{0С 9с(111$); 
ОпРгерагеоС( &4с):; 
т_гестТгаскег = м_Тгаскег. п_гес*; 
дс. ОРтоР(п_гес{Тгаскег); 
Тпуа11дате(); 


Пример Ех24а: передача объекта данных 
через буфер обмена 


В этом примере используется класс СО из ЕхОба. Вы сможете перемещать и 
масштабировать О!В-изображение с помощью ограничивающего прямоугольни- 
ка, а также копировать О1В в буфер обмена и вставлять его оттуда в документ че- 
рез объект данных СОМ. Кроме того, в примере реализованы функции для чте- 
ния и записи ОТВ в ВМР-файлы. 

Если вы создаете проект с самого начала, воспользуйтесь мастером МЕС Аррп- 
сайоп \/Лага, сбросив все флажки, относящиеся к АсйуеХ и АиютанНоп, а потом 
добавьте в файл 5{ААЁх.В строку: 


Н1ис1иде <атхо1е. п> 
а в начало тела функции [ипЯапсе приложения — вызов: 


АРхО1е1п1*(); 
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Чтобы подготовить Ех24а к работе, откройте и соберите проект \усррпе\Ех24а\ 
Ех24а.51п. Запустите программу и вставьте растровое изображение командой Разе 
Егот в меню Еай (рис. 24-2). 


Рис. 24-2. Программа Ех24а в действии 


Класс СМатЕгате 


Содержит обработчики ОпОиегуМешРщейе и ОпРейеСрапвей сообщений М Г ООЕ- 
КУМЕУРАГЕТТЕ и ИМ_РАГЕТТЕСНАМСЕР соответственно. Эти обработчики отправ- 
ляют пользовательское сообщение М_ИЕВУРАГЕТТЕСНАМСЕР во все окна пред- 
ставления, затем вызывается СР ::ОзеРщейе для реализации палитры. Значение 
шРагат сообщает, должна ли палитра реализовываться в фоновом режиме или нет. 


Класс СЕх24а)ос 


Весьма простой класс: содержит внедряемый СРф-объект т_@ и обработчик 
команды Сеаг АН. Переопределенная функция-член Ре/ееСотеп!5 вызывает функ- 
цию СБ: Етрё). 


Класс СЕх24аМеи/ 


Содержит обработчики команд, связанные с буфером обмена, код, отслеживаю- 
щий поведение ограничивающего прямоугольника, а также код прорисовки ОТВ. 
Листинг класса приведен ниже; код, введенный вручную, выделен. 


Ех24аМем.н | 


// Еха4а\лем. В. зпхеггасе ог Че свомаем < С1аз 

ий 
#ргадта опсе. _ 
#4ег1те ММ оЕИРАСЕТТЕСНАНОЕО м ЕЯ о 

° (1а93 оБха4а\ен и 
; - : з __ 


// Для отслеживания ограничив: о прямоугольника 
СВестТгаскег т_Тгаскег; 
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см. след. стр. 
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В классе «вид» происходит несколько интересных вещей. Во вспомогательной 
функции РоРаяеГЛр мы можем вызвать бсестораШеиа, потому что можно подсо- 
сдинить возвращаемую переменную типа НСГОВАЕ к объекту СОА в документе. Если 
бы мы вызвали СеДеа, нам пришлось бы самим копировать блок памяти. Обра- 
ботчики команд Разе Егот и Сору То опираются на поддержку проецируемых в 
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память файлов, заложенную в класс СО. Функция ОпРгератерС создает особый 
режим преобразования координат на принтере, совпадающий с ММ [ОЕМСИ$Н 
за исключением того, что ось у направлена вниз (т. е. положительные значения 
координаты по оси откладываются вниз). Одна точка на экране соответствует 
0,01 дюйма на принтере. 


Поддержка операции @4гад-ап4-дгор в МЕС 


Самый веский аргумент в пользу кода объекта данных — возможность поддерж- 
ки операции Чгаз-ап4-4гор. ОТЕ предоставляет для этого интерфейсы /Оторбоитсе 
и Ргор1Татзе, а также библиотечный код, управляющий процессом перемещения 
объектов. Библиотека МЕС поддерживает га-ап4-агор на уровне класса «вид», чем 
мы и воспользуемся. Учтите, что в процессе выполнения агаэ-ап4-агор данные 
передаются напрямую и независимо от буфера обмена. Если пользователь отме- 
няет операцию, никакой информации о перемещаемом объекте не сохраняется. 

С точки зрения пользователя, передача данных операцией @газ-ап4-4гор меж- 
ду приложениями, окнами в одном приложении и в пределах конкретного окна 
ничем не отличается. Когда начинается эта операция, форма курсора должна из- 
меняться на стрелку с прямоугольником. Если пользователь удерживает клавишу 
С знак плюс (+) в изображении указателя информирует, что объект копирует- 
ся, а не перемещается. 

МЕС поддерживает также операцию @га?-ап49-4гор для элементов составных 
документов. Это следующий, более высокий уровень поддержки ОТЕ в МЕС, кото- 
рый в этой главе не рассматривается. Подробнее см. пример ОСИЕМТ в разделе 
У15ча! С++ 5атр/ез в МОМ ГАБгагу. 


Что происходит в источнике 


Начиная операцию агаз-апа-агор для объекта данных, программа-источник вы- 
зывает СОеБеа$оигсе::РортаеОтор. Эта функция создает объект МЕС-класса СОе- 
Ртор5оитсе, реализующего интерфейс /тор5оигсе. РоБтав)тор — из числа тех 
функций, что возвращают управление не сразу. Возврат из нее происходит, толь- 
ко когда пользователь «отпускает» объект или отменяет операцию либо когда про- 
ходит заданное количество миллисекунд. 

Если вы программируете агаз-ап4-агор так, чтобы эта операция работала с 
объектом СКесИтасвет, то РобтавОтор следует вызывать, только если пользователь 
щелкает мышью внутри ограничивающего прямоугольника, но не на рамке. Нуж- 
ную информацию даст функция СКесИтгасвег::НИТез. Перед вызовом РортавОтор 
следует установить флаг, который подскажет, не «отпущен» ли объект там же, от- 
куда началось его перемещение. 


Что происходит в приемнике 


Чтобы задействовать для агаз-апа-агор поддержку из класса «вид» библиотеки МЕС, 
добавьте в свой производный класс «вид» переменную-член класса СОеБторТатоей. 
Класс СОерторТатвей реализует интерфейс ШторТатве! и хранит указатель на 
Штор5оигсе, обеспечивающий обратную связь с объектом СОе)тор$оихтсе. В функ- 
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ции ОптииаЮраще вашего класса «вид» вызовите функцию-член Кесет для вне- 
дряемого объекта СОеБторТатве!. 

Создав СОерторТатвей для своего класса «вид», переопределите четыре вирту- 
альные функции СУеш, которые МЕС вызывает в процессе выполнения @агаз-апа- 
гор. Вот что должны делать эти функции, если вы применяете класс СЮесИтасвек 


Функции Описание 
ОпртгавЕщет Корректирует прямоугольник фокуса и вызывает ОпртавОиет. 


ОпртавОует Перемещает пунктирный прямоугольник фокуса и определяет момент 
«отпускания» объекта (задает форму курсора). 


ОпртавЁеше — Отменяет операцию и возвращает исходные размеры и координаты 
прямоугольника. 


Опртор Корректирует прямоугольник фокуса и вызывает вспомогательную 
функцию РоРазе, чтобы извлечь форматы из объекта данных. 


Последовательность действий при Чгад-апа-дгор 
Рис. 24-3 иллюстрирует обработку операции Чга?-ап4-агор в МЕС. 


т... _ 


2” ^- 5, . 

„ Пользователь @®  СОебгортагае 
„ отпускает кнопку _ __ 
' в окне прило- 
: жения-приемника 


Саспеб/ова/раа 


СОеОгорбоигсе | 


/Огорбоигсе бес/овараа 


ФиегуСоппие0гад 


Рис. 24-3. Обработка операции атаз-апа-атор в МЕС 


Вот что происходит в процессе выполнения Чгаз-апа-агор. 

Пользователь нажимает левую кнопку в окне представления источника. 
Обработчик кнопки вызывает СКесИгасвег::НИТе$ и выясняет, расположен ли 
курсор внутри ограничивающего прямоугольника. 

Обработчик сохраняет форматы в объекте СОерайя$оихсе. 

Обработчик вызывает СОеВБая$оигсе::РортавОтор для источника данных. 
Пользователь перемещает курсор в окно представления приемника. 


ОТЕ вызывает /РгорТатве!::ОпртавЕтщег и ОпргавОьет для объекта СОеБторТатве, 
в результате чего вызываются соответствующие виртуальные функции класса 
«вид» приемника. Функции ОпртавОшет передается указатель на сОерааОБес 
для объекта-источника, который получатель использует для проверки наличия 
поддерживаемых им форматов. 


м 


Е Ба 
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7. ОпргавОьег возвращает код эффекта «отпускания», используемый ОГЕ для уста- 
новки формы курсора. 

8. ОТЕ вызывает Штор$оигсе::ОиетуСопипиертав на стороне источника, чтобы 
определить, продолжать ли операцию перемещения. МЕС-класс СОера$оитсе 
реагирует соответственно. 

9. Пользователь отпускает кнопку мыши, чтобы «оставить» объект в окне пред- 
ставления приемника. 

10. ОГЕ вызывает ШторТатве::ОпОтор, а та — ОпОтор класса «вид» приемника. Так 
как Оп)тор передается указатель на СОереяОБ:есь она может выбрать из этого 
объекта данные в нужном формате. 

11.Когда ОпОтор программы-приемника возвращает управление, ДортазОтор в 
программе-источнике тоже может вернуть управление. 


Пример Ех24Ь: ОЁЕ агад-апд-агор 


Эта программа принимает эстафету у Ех24а. В нее добавлена поддержка @газ-ап4- 
гор с использованием уже имеющихся вспомогательных функций 5азеГр и 
РоРаЯер\. Код для работы с буфером обмена тот же. Этот пример можно адап- 
тировать для других приложений, требующих применения агаз-ап4-агор для объек- 
тов данных. 

Для подготовки Ех24Ь откройте и соберите решение \усррпе\Ех24\Ех24Ъ.5]п. 
Запустите приложение и попробуйте что-нибудь переместить мышью между его 
дочерними окнами и между копиями этой программы. 


Класс СЕх246)0ос 


Этот класс почти такой же, как СЕх24а0ос, кроме новой переменной-члена т_ВОтаз- 
Нете, используемой как флаг. Если его значение равно ТКОЕ, идет операция агаз- 
апа-агор для данного документа. Флажок задан для документа, а не для окна пред- 
ставления, так как у одного документа может быть несколько представлений. Пе- 
ремещать О!В из одного окна представления в другое бессмысленно, если оба они 
ссылаются на т_@ из одного документа. 


Класс СЕх246УГеи/ 


В этом классе три дополнительных переменных-члена и конструктор, их иници- 
ализирующий: 


САесф м_гес{ТгаскегЕптег; // исходные логические координаты 
С01е)горТагдет м_дгорТагдет; 
(С517е м_дгад0Рзе{; // аппаратные координаты 


СЕх246\1ем: : СЕх246\М1ем() : м_$126еТ01а1(800, 1050), // 8х10,5 дюймов при печати 
т_гес{Тгаскег(50, 50, 250, 250), 
п_Огад0Рзет(0, 0), 
п_гестТгаскегЕптег(50, 50, 250, 250) 
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В функции ОптимаяЮраще нужна дополнительная строка для регистрации по- 
лучателя: 


т_ЧгорТагдает. Ведтз1ег( 111$): 


А теперь посмотрим на переопределенные виртуальные функции для Чгаз-апа- 
Чгор. Заметьте, что Оптор заменяет П1В, только если флажок 77 _ЬОгавНете в до- 
кументе равен ТКОЕ, поэтому, когда пользователь «отпустит» БВ в том же окне (или 
в другом окне, подсоединенном к тому же документу), ничего не произойдет. 


ОВОРЕЕРЕСТ СЕх246 тем: :ОпбгадЕпег(С01еБата0ь ест» рбата0Б)ест, 
ОМОНО дмКеузтате, СРо1пЕе ро1пЕ) 


{ 
ТВАСЕ ( “Епфег1п9 СЕх246У1ем: :ОпОгадЕптег, ро1пЕ = (%4, %9)\п" 
ро1пт.х, ро1пт.у); 
п_гестТгаскегЕпфег = п_гес{Тгаскег;: // Сохранить начальные координаты на случай 
// если объект не “отпустят” на новом месте 
СС11епт0С 9с(111$); 
ОпРгерагеоС (&4с); 
9с.ОгамРосизВес* (п_гес+Тгаскег); // будет стерт в ОпОгад0\ег 
гефиги Опбгад0уег (рбата0Б]ест, диКеубтате, рофп+): 
} 
\01а СЕх246\1ем: :ОпОгадЁеаме() 
{ 
ТВАСЕ( "Епфег1п9 СЕх246\1ещ: : Оп0гадЕеаме\ п”); 
СС11епт0С 9с(+11$): 
ОпРгерагеос(&9с); 
9с.ОгамРосизВес* (т_гесТгаскег): 
п_гесЕТгаскег = т_гес{ТгаскегЕптег; // Восстановление начальных координат 
} 


ОВОРЕЕРЕСТ СЕх246\1ем: :ОпОгад0мег( С01еПафа0ь]ест* рбафа0Б]ес+, Омово 
9мКеубтате, СРо1пе ро1п{) 
{ 
ЛЕ (!рбата0Б)ес+->ТзбатаАуа11а61е(СЕ_ОТВ)) { 
гефигп ОВОРЕРРЕСТ_МОМЕ 
} 
МоуеТгаскВес{ (ро1пт):; 
11((диКеузфате & МК_СОМТВОГ) == МК_СОМТВОЕ) { 
гефигп ОНОРЕЕРЕСТ_СОРУ; 
} 
// Проверка на принудительное перемещение 
11 ((д\Кеубзфате & МК_АЁТ) == МК_АЁТ) { 
гетигп ОНОРЕЕРЕСТ_МО\МЕ; 
} 
// По умолчанию рекомендуется предполагать перемещение 
гефтигп ОАОРЕРРЕСТ_МОУЕ: 
} 
ВООЕ СЕх246\М1ем: : ОпОгор(С01ебата06 ест рбатаО06ест, 
ОРОРЕРРЕСТ дгорЕТРес+, СРо1пе ро1п+) 
{ 
ТВАСЕ( “Епфег1п9 СЕх246М1ем: :ОпОгор - ЧгорЕРТест = %а\п”", агорЕРРест): 
ВОО Вет; 
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СЕх24600с* р0ос = бетбоситепт() 

Мо\уеТгаскВест (ро1п{); 

11 (рбос->т_БОгадНеге) { 
рдос->м_6ОгадНеге = РАШУЕ; 


Вет = ТНИЕ; 
} 
е1зе { 

Вет = боРаз{е016 (рбафа0Ь ест); 
} 


гефигп Вет; 


Обработчик сообщения М _[ВИТТОМРО\М требует существенной модифика- 
ции. Он должен вызывать РортгаеОтор, если курсор находится в прямоугольнике, 
и Ггасй — если на его рамке. Вот новый вариант кода: 


\у019 СЕх246\1ем: : ОпЕВиопбомп(ИТМТ пЕ1адз, СРо1п ро1п{) 


{ 
СЕх24600с* р0ос = @е{боситеп{(); 
1 (т_{гаскег. Н1Тез{(ро1п®) == САесеТгаскег: :п1{М1991е) { 
С01ебафабоигсе» рЗоигсе = $аме016():; 
1 (рЗоигсе) { 
// бобгад0гор возвращает управление только по окончании перемещения 
(С11еп0С 9с(111$); 
ОпРгерагеосС( &9с); 
СРо1п{ фор1етЕ = м_гес{Тгаскег. ТорЕет*(); 
дс. ЕРтоОР ( &+ор1ет{); 
// ’ро1п’ здесь не то же самое, что параметр ро1зпф в ОпОгадЕптег 
// поэтому мы используем его для вычисления смещения 
п_Огад0тРзет = ро1пф - фор1еЁ{; // аппаратные координаты 
рбос->т_6бгадНеге = ТВИЕ; | 
ОВОРЕРРЕСТ агорЕЁРес{ = р5оигсе->бо0гад0гор( 
ОВОРЕЕЕЕСТ _МО\УЕ' ОВОРЕРРЕСТ_СОРУ, СВест(0, 0, 0, 0)): 
ТВАСЕ( "аРфег Оо0гадОгор - ЧгорЕРРест = %19\п", агорЕРТест): 
11 (@горЕГРесф == ОАОРЕРРЕСТ_МОМЕ && р0ос->т_6ОгадНеге) { 
рбос->0пЕд1{С1еага11(); 
} 
р0ос->м_6ОгадНеге = РАШЗЕ; 
де1ете р5оигсе; 
} 
} 
е1зе { 
1 (т_тгаскег. Тгаск({11$, роли, РАЕЗЕ, МЕ)) { 
СС11еп{0С 9с(111$); 
ОпРгерагебС( &ас) 
// надо как-то предотвратить выход за границы 
п_гестТгаскег = м_{гаскег. п_гест; 
9с. ОРфоЕР(т_гестТгаскег); // Обновляем логические координаты 
} 
} 
Тпуа11дафе(); 
} 
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И, наконец, новая вспомогательная функция МогеТуасЕКесь, показанная ниже, 
перемещает прямоугольник фокуса при каждом вызове ОпргавОуег. В примере 
Ех24а эту работу выполняла СКесИгасвег::Тртаск. 


у014 СЕх246\1ем: :МоуеТгаскВес* (СРо1пе ро1пе) 
{ 
СС11епЕ0С ас(111$); 
ОпРгерагеоС (&4с); 
ас. ОгамРосизВест (м_гес{Тгаскег); 
дс. ЕРЕоОР(т_гес+Тгаскег); 
(517е $17еТгаск = м_гестТгаскег. 517е(); 
СРо1пЕ пемТор1егЕ = ро1п{т - м_9гадотЕзет; // по-прежнему аппаратные координаты 
п_гесЕТгаскег = САест(пемТор1еге, $1теТгаск): 
т_Тгаскег. т_гесе = м_гестТгаскег; 
ас. ОРто|Р(т_гес1Тгаскег); 
дс. ОгамгосизВест (м_гес{Тгаскег); 


Мы тестировали Ех24Ь с пакетом М!сгозой ОЁйсе ХР, опробовав передачу дан- 
ных как через Чгар-апа-4гор, так и через буфер обмена. Формат СЁЕ_ГИВ здесь от- 
сутствует. Так что, если вы хотите вставлять картинки из Ехсе!, в Ех24Ь надо вве- 
сти поддержку метафайлов. 


ГЛАВА 


25 


Основы АТ 


В этой главе мы рассмотрим второй (если первым считать МЕС) каркас прило- 
жений, в составе Мсгозой У1зиа! С++ МЕТ — Аснуе Тетр!ае ГБгагу (АТГ). Для на- 
чала вспомним СОМ, затем рассмотрим альгернативный способ написания объекта 
С5расезр из главы 22, чтобы показать разные методы написания СОМ-класса. (Это 
будет важно при рассмотрении методов композиции классов АТГ.) Далее мы изу- 
чим АГ, сосредоточившись сначала на шаблонах и обычных зтаг-указателях С++ 
и их применении в разработке СОМ объектов. Потом мы обсудим программиро- 
вание на АТ! со стороны клиента и некоторые из зтап-указателей АТГ. Наконец, 
мы придем к программированию серверов на АТ, заново реализовав с ее помо- 
щью пример космического корабля из главы 22, что даст нам представление об 
архитектуре АТГ. 


Снова СОМ 


Краеугольный камень СОМ — интерфейсы. Как вы узнали из главы 22, ни СОМ, 
ни какая-либо поддержка периода выполнения не нужны для программирования 
при помощи интерфейсов. Все, что вам нужно, — это дисциплина. 

Вернемся к примеру космического корабля из главы 22. Мы начали с одного 
класса Сбрасез р, реализующего несколько функций. Опытные разработчики на 
(С++ обычно начинают писать класс примерно так: 


с1азз СЗрасезй1р { 
\019 Е1у(); 
11& бе{Роз1110п(); 
| 


Однако при разработке на основе интерфейсов процедура немного отличает- 
ся. Вместо написания класса напрямую интерфейс сначала обговаривается, а по- 
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том реализуется. Ранее функции Е) и СеРояйоп переводились в абстрактный 
базовый класс [Мойоп. 


УЕгисЕ ТМо1оп { 

У1гфиа1 №019 РЛу() = 0; 

\1гфиа1 1п1& бетРо$1410п() = 0; 
}; 


Затем класс Сбрасезрр объявлялся производным от интерфейса /Мойоип: 


с1аз$ Сбрасезй1р : ТМо{1оп { 
№019 Е1у(); 
111% @е+Ро$1{10п(); 

|. 


Обратите внимание: интерфейс движения (тоНоп) отделен от своей реализа- 
ции. При разработке интерфейсов вы можете изменять их, стремясь сделать пол- 
ными, но в то же время не слишком раздутыми. Но как только интерфейс опуб- 
ликован (т. е. другие разработчики начали его использовать), он замораживается 
и никогда не изменяется. 

Такое небольшое различие между программированием на основе классов и на 
основе интерфейсов создает некоторые проблемы. Однако это один из ключевых 
моментов для понимания СОМ. Собрав вместе функции Ей и СеРоз#оп, вы раз- 
работали двоичную структуру. Если есть предварительно определенный интерфейс, 
то общение с классом через интерфейс позволяет клиенту получить потенциаль- 
но не зависящий от языка способ общения с классом. 

Группировка функций в интерфейс сама по себе очень полезна. Допустим, 
вы хотите описать что-нибудь отличающееся от космического корабля, скажем, 
самолет. Ясно, что у него также должны быть функции Е) и СеРозйоп. Про- 
граммирование на основе интерфейсов предоставляет более широкую форму 
полиморфизма — полиморфизм на уровне интерфейсов, а не на уровне одной 
функции. 

Разработка на основе интерфейсов базируется на отделении интерфейса от 
реализации. СОМ ориентирована на программирование интерфейсов и заставляет 
разделять интерфейс и реализацию. Единственный способ общения клиента с 
объектом согласно СОМ — интерфейс. Однако сведения функций вместе в интер- 
фейс недостаточно. Нужен еще один ингредиент — механизм для выяснения фун- 
кциональности во время выполнения. 


Базовый интерфейс /Шпкпоит 


Основное правило, отличающее СОМ от обычного программирования на основе 
интерфейсов, заключается в том, что названия первых трех функций совпадают 
во всех СОМ-интерфейсах. Базовый интерфейс СОМ — Шийпошт — выглядит так: 


ЗЕгисе ТОпкпомп { 
У1гфиа1 НВЕЗИЕТ ОиегуТптегРасе(ВЕРТТО г119, \014*» рру) = 0; 
\1гфиа1 ЦОМ@ Адавее() = 0; 
У1гфиа1 Ц10№ Ве1еазе() = 0; 

} 
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Все СОМ-интерфейсы наследуют именно ему (что делает Оцегушег асе, АааКе} 
и Кееазе первыми тремя функциями всех СОМ-интерфейсов). Для преобразова- 
ния (Мойоп в интерфейс СОМ его нужно преобразовать в интерфейс, производ- 
ный от Юмёпоит: 


УЕгисф ТМот1оп : ПпКпомп { 
№019 Е1у(); 
111& бе{Ро$1{10п(); 


— 


Примечание Если вы хотите, чтобы интерфейс работал за пределами процес- 
са, сделайте у каждой функции возвращаемое значение типа НВЕЗОТЛ. 
Подробнее об АТИ, с атрибутами мы поговорим позже. 


АаЯКеГи Кёеа$е требуют некоторого внимания, так как являются частью /иЁ- 
пошт. Они позволяют объекту контролировать свое время жизни. Как правило, 
клиенты трактуют указатели на интерфейсы как ресурсы: клиенты запрашивают 
интерфейсы, используют их и освобождают, когда те становятся ненужными. 
Объекты узнают о новых ссылках на себя через АдЯКе}, а об освобождении — че- 
рез Кееае. Объекты часто используют эту информацию для управления своей 
«жизнью». Например, многие объекты самоуничтожаются, когда их счетчик ссы- 
лок обнуляется. 

Вот как код клиента мог бы использовать космический корабль: 


\019 Узебрасезв1р() { 
ТМо{1оп* рМоф1оп = МЕ; 


рМо{1оп = бефАбрасезй1р(); // Это функция гипотетического Зрасезн1р АРТ. 
// Она скорее всего является точкой входа в некоторую БЦ, 
// возвращает ТМо10оп* и выполняет  неявный вызов АдаВет. 
ТЕ (рМот1оп) { 
рМот1оп->Е1у(); 
11 1 = рМо{1оп->бе{Роз1110п(); 
рМо{1оп->Ве1еазе(); // закончили с этим экземпляром СЗрасези1р 


Последняя (и самая важная) функция ЮиЁпошп — это его первая функция 
Онетуйщет/асе. Она является механизмом выяснения функциональности во время 
выполнения. Если вы получили указатель на интерфейс и не хотите использовать 
именно его, то вы можете при помощи указателя запросить у объекта другой 
интерфейс. Данный механизм, а также тот факт, что интерфейсы остаются неиз- 
менными с момента публикации, позволяют ПО на основе СОМ безопасно эво- 
люционировать во времени. В резульгате вы можете добавлять функциональность 
в ПО без переделки старых версий клиентов, использующих это ПО. Кроме того, 
у клиентов есть широко известные средства получения этой функциональности, 
если они о ней знают. Например, вы добавили функциональность в С5брасезРр, 
реализовав новый интерфейс П/биа/. Такой интерфейс имеет смысл, потому что 
у вас есть объект, находящийся в трехмерном пространстве и двигающийся к или 
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от наблюдателя. Кроме того, у вас можёт быть невидимый объект (черная дыра, 
например). 1/5 и может выглядеть так: 


Эфгисе 1\1$иа1 : Цпкпомп { 
\1гфиа1 №019 01$р]ау() = 0; 
| 


Клиент может использовать /Убиа/ следующим образом: 


\019 Цзебрасезй1р() { 
ТМот1оп* рМот1оп = МЕ; 


рМо1оп = бетАбрасезй1р(); // Неявный вызов Адавее 
ТЕ(рМот1оп) { 

рМо{10п->Е1у(); 

11 1 = рМот10оп->бе{Роз1410п(); 


1\М1$иа1* р\1$иа1 = МЕ; 
рМот1оп->ОцегуТитегРасе(ТТО_1Т\1$иа1, (\019**) &р\13иа1); 
// Неявный вызов АдаВеР внутри ОбиегуТптегРасе 


1Е(р\1$ца1) { 
р\/1$на1->013р1ау(); // теперь видимый 
р\15иа1->Ве1еазе(); // закончить с этим интерфейсом 


} 


рМо{1оп->Ве1еазе(); // закончить с этим экземпляром ТМо*{10оп 


В этом коде указатели на интерфейсы используются очень осторожно: они 
применяются, только если интерфейс получен корректно, и освобождаются, ко- 
гда интерфейсы более не нужны. Это обычное низкоуровневое СОМ-программи- 
рование: вы запрашиваете указатель на интерфейс, используете указатель на ин- 
терфейс, освобождаете его, когда он более не нужен. 


Написание СОМ-кода 


Как вы видели, написание кода СОМ-клиента не сильно отличается от написания 
обычного кода С++. Однако классы С++, с которыми имеет дело клиент, — это 
базовые абстрактные классы. Вместо вызова орегейюог пеш», как это было в С++, вы 
создаете СОМ-объекты и запрашиваете СОМ-интерфейсы путем явного вызова 
нескольких АР!Г-функций; а вместо удаления объекта вы просто следуете правилу 
СОМ о равенстве числа вызовов АЧЯКе[и Кееа$е. 

Что требуется для создания работающего СОМ-класса? Вы видели в главе 22, 
как сделать такой класс при помощи МЕС. Здесь приводится другой пример реа- 
лизации СбрасезЬр как СОМ-класса, в котором используется множественное на- 
следование. Класс С++ наследует несколько интерфейсов и реализует все их функ- 
ции (включая /ОиЁпоит, естественно). 


Эфгисф СЗрасезрар : ТМоф1оп, ТО15р]ау { 
(10№  т_свет; 
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ТП м_пРо$1{10п 


Сбрасезй1р() : м_сВе!(о0), 
т_пРо$1{10п(0) { 


} 


НВЕЗУЕТ ОиегуТпфегРасе(ВЕРТТО г119, \№019** рру); 
(1Ом№ Ааавег() { 
гефтигп ТптегоскедТпсгетеп: ( &м_сВеР); 
} 
(1ОМ№б Ве]еазе() { 
иЕОм@ сВег = Тпфег1оскедТпсгетеп* (&м_сВеГ); 
1е(сНеЁ == 0){ 
9е1ете 111$; 
гетигп 0; 


} 
е1зе 
гефигп т_сВег 


// Функции ТМот1оп: 
№019 Е1у() { 
// Здесь располагается весь необходимый для полета код 
} 
11 бетРо$1110п() { 
гефигп м_пРо$110п; 


} 


// Функции Т\13иа1: 

\019 01$р1ау() { 
// Показать 

} 


СОМ-классы на основе множественного наследования 


Если вы привыкли к обычному коду С++, то предыдущий код может показаться 
вам слегка странным. Это не совсем обычная форма множественного наследова- 
ния, называемая наследование интерфейса (ицегасе шБегшапсе). Большинство 
разработчиков на С++ пользуется наследованием реализации (ипр!етегианоп 
шбегиаосе), при котором производный класс наследует от базового все, в том числе 
его реализацию. Наследование интерфейса просто означает, что производный класс 
наследует интерфейсы базового класса. Код, приведенный выше, добавляет в класс 
С5расезрр две переменные-члены — указатели на каждою невидимую, но подра- 
зумеваемую хаЫе. 

В случае множественного наследования для реализации интерфейсов все они 
совместно использует реализацию /Сиёпошт в Сзрасезвр. Это иллюстрирует дру- 
гое известное только посвященным, но важное понятие — речь идет о единстве 
в смысле СОМ (СОМ 1аепщу). Основная идея единства в СОМ состоит в том, что 
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ГОткпоит в СОМ — это то же, что го» в С++. Юпкпоит — единственный интер- 
фейс, который гарантированно есть в любом объекте, и указатель на него всегда 
можно получить. Клиент может вызвать Онегуйщетасе через интерфейс {Мойоп 
объекта С5расезрр для получения интерфейса 1/15. И наоборот, клиент может 
вызвать Оиегу/тщегасе через интерфейс П/5Й\е объекта С5расезрр для получения 
интерфейса /Мойоп. Наконец, клиент может вызвать Оиегу/щекасе через интер- 
фейс /Юиепоит для получения Мойоп или ИЗ или через [Мойоп или Ме для 
получения /ОиЁёпоши. О единстве в смысле СОМ см. книги Дона Бокса (оп Вох) 
«Е5зеп Иа! СОМ» (Аа1зоп-Уе$еу, 1997) и Дейла Роджерсона (Рае Ковегзоп) «ше 
СОМ» (М1сгозой Рге$$, 1997) (Роджерсон Д. Основы СОМ. 2-е издание. М.: Русская 
Редакция, 2000). 

Часто можно видеть СОМ-классы в виде прямоугольников с кружочками ин- 
терфейсов, реализованных в этих классах. Пример такой диаграммы приведен в 
главе 22 в разделе «Интерфейс (Опепоит и функция-член Оиег/тег асе». 

Множественное наследование при реализации Сбрасез р автоматически удов- 
летворяет правилам единства в СОМ. Заметьте: все вызовы Оиегуйщет/асе, АЯаКеГ 
и Кееазе передаются в одни и те же функции-члены класса С++ независимо от 
интерфейса, через который они вызваны. 

Вот более или менее вся сущность СОМ. Вы, как разработчик, создаете полез- 
ные сервисы и предоставляете их клиенту через СОМ-интерфейсы. На самом 
низком уровне это означает наличие нескольких таблиц функций, удовлетворя- 
ющих правилам СОМ. К настоящему времени вы видели два способа реализации 
этого. (В главе 22 показано, как это сделать при помощи вложенных классов и МЕС. 
В данной главе мы только что написали СОМ-класс при помощи множественно- 
го наследования.) Однако в СОМ есть еще несколько важных вопросов, помимо 
программирования интерфейсов и написания классов для их реализации. 


Инфраструктура СОМ 


Хотя концепция программирования на основе интерфейсов вам известна, есть 
довольно много деталей, которые нужно реализовать, чтобы ваш класс стал час- 
тью системы. Эти детали часто затемняют фундаментальную красоту СОМ. 

Для начала СОМ-классам нужно место для жизни, поэтому вы должны помес- 
тить их в ЕХЕ или РИ. Кроме того, каждому СОМ-классу нужен соответствующий 
объект класса, часто называемый фабрикой класса (с1а$$ гасгюгу). Способ обращения 
к объекту класса СОМ-сервера зависит от размещения самого класса СОМ (в РИ, 
или ЕХЕ). Необходимо также учесть время жизни сервера. Сервер должен оста- 
ваться в памяти, пока он нужен, и удаляться, как только в нем больше нет необхо- 
димости. Для этого серверы содержат глобальные счетчики блокировок, соответ- 
ствующие количеству объектов, имеющих указатели на интерфейсы. Наконец, 
корректно работающие серверы добавляют в реестр УЛа4о\5 параметры, облег- 
чающие запуск клиентов. 

Как вы помните, МЕС заботится о большинстве деталей программирования на 
основе СОМ (см. главу 22). Так, в ССтаТатее есть реализация /Иткпоит. МЕС даже 
создает классы С++ и макросы, реализующие объекты класса (например, СОЁ- 
ОБесасюту, СИеТетрще$етьет, РЕСГАКЕ_ОГЕ_СКЕАТЕ и [МРЕЕМЕМТ _ОГЕ_СКЕАТЕ), 
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которые помещают в реестр большинство нужных записей. В МЕС есть самая про- 
стая в использовании и быстрая версия /Оёбреср, поэтому все, что вам нужно, — 
это объект ССтЯТатоей и среда У15иа! Зо МЕТ (мастера Ааа Ргорегу УЛгаг4 и 
АЯ Метод УЛ гага). Если вам требуется ОГЕ агаз-ап4-агор, МЕС предоставляет стан- 
дартную реализацию этой операции. Наконец, МЕС, бесспорно, остается простей- 
шей технологией для написания быстрых и мощных элементов управления Асцуех. 
(Их можно писать и на М1сгозой У15ча! Ваз1с, но этот язык не обеспечивает доста- 
точной гибкости.) 

Это были достоинства. Теперь о недостатках. Во-первых, для использования всех 
этих возможностей нужно знать МЕС на все сто. Во-вторых, решившись на при- 
менение МЕС, надо представлять себе цену этого решения. МЕС огромна. Она 
должна быть такой, поскольку является каркасом приложений на С++ с большим 
количеством возможностей. 

Как вы могли видеть из ранее рассмотренных примеров, реализация СОМ-клас- 
сов и предоставление клиентам доступа к ним требует написания большого объема 
кода — кода, который не изменяется от реализации одного класса к реализации 
другого. Например, реализация П/лиёпоит обычно одна и та же для любого СОМ- 
класса — основное различие между ними в интерфейсах, предоставляемых каж- 
дым классом. 

Прежде чем «нырнуть» в глубины АТГ, бросим беглый взгляд на общую карти- ` 
ну, частью которой являются СОМ и АГИ. 


АсНуехХ, ОЁЕ и СОМ 


СОМ — это всего лишь «арматура» для нескольких высокоуровневых технологий, 
таких как элементы управления АсйуеХ и ОГЕ агаз-ап4-агор. Можно реализовать 
высокоуровневые возможности ОГЕ-документов и элементов управления самосто- 
ятельно, однако разумнее предоставить эту работу какому-нибудь каркасу прило- 
жений, в первую очередь МЕС. 


Примечание Подробнее о реализации высокоуровневых функций в «сыром» 
(С++ см. книгу Крейга Брокшмидта (Кга1е Вгоскзсвимаю) «ше ОГЕ» (Масго- 
зоЁ Ргезз, Зесопа Е оп, 1995). 


АсНуехХ, МЕС и СОМ 


Хотя СОМ-‹арматура» интересна сама по себе (например, просто изумительно 
наблюдать, как работает распределенная СОМ), именно высокоуровневые возмож- 
ности создают продаваемые приложения. МЕС — это огромный каркас, предназ- 
наченный для создания целых \/шаоу\’-приложений. В МЕС вы найдете «тонны» 
полезных классов, механизм управления-представления данных (архитектура «до- 
кумент-вид»), поддержку @газ ап4 агор, Аи{отайоп и АсйуеХ-элементов. Вам ско- 
рее всего не захочется с нуля разрабатывать приложение ОГЕ @газ апа Чгор — лучше 
использовать МЕС. Однако если необходимо создать небольшой или средних 
размеров сервис на основе СОМ, то вы вряд ли захотите тащить в него весь «ба- 
гаж», который МЕС применяет для поддержки высокоуровневых возможностей. 
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Для создания СОМ-компонентов можно использовать обычный код на С++, но 
тогда большая часть времени уйдет на написание стереотипного кода (например, 
для интерфейса Ютёпоит и объектов класса). Применение МЕС для создания 
приложений на основе СОМ — наименее болезненный способ добавить крупные 
элементы в приложение, но на МЕС тяжело писать простые СОМ-классы. АТИ. по- 
зиционируется между чистым С++ и МЕС как способ реализовать ПО на основе 
СОМ без написания стереотипного кода или изучения всей архитектуры МЕС. АТГ, 
представляет собой набор шаблонов С++ и других средств, облегчающих написа- 
ние классов СОМ. 


Путеводитель по АТЁ 


Если вы посмотрите на исходный код библиотеки АТИ, то увидите, что вся она 
содержится в нескольких файлах С++, большинство из которых находится в под- 
каталоге АТЕМЕС\асшае каталога с Мсгозой У15ца1 $ ю МЕТ. Далее приведено 
описание некоторых файлов АИ, и того, что находится в них, 


АНВазе.п 


Этот файл хранит: 

Ш объявления функций АТГ; 

определения структур и макросов; 

описания зтап-указателей, управляющих указателями на СОМ-интерфейсы; 
классы поддержки синхронизации потоков; 


определения классов: ССотВУТК, ССотиИатать поддержки потоков и разделе- 
НИЯ ПОТОКОВ. 


АНСот.П 


В этом файле находятся: 


Ш шаблоны классов для поддержки фабрик классов (объектов класса); 
реализации интерфейса ШЮиЁпоии; 

поддержка для обособленных (1еаг-ой) интерфейсов; 

поддержка получения информации о типе; 

реализация Дёрейср; 

шаблоны классов-перечислителей; 

поддержка точек соединения. 


АНСопу.срр и АНСопу.В 


Эти файлы обеспечивают поддержку преобразования Отсоае-строк в АМЗГ и об- 
ратно. 


АНСН.срр и АНСН.А 


В этих двух файлах хранятся: 


Ш исходный код АТ. для поддержки /Оёресь со стороны клиента и поддержки 
генерации событий; 
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Ш СотСопио!Вазе; 
Ш поддержка механизма внедрения объектов; 
№ поддержка страниц свойств. 


АРасе.14! и АНРасе.п 


АЧГЕасела! (и генерируемый из него АШЕасе.В) содержит специальный АТГ-интер- 
фейс Кезятаг. 


АНтр!.срр 


Реализует некоторые классы, например ССотВУТК, объявленный в АИВазе. 


АН\М/т.срр и АН\И т. 


Эти файлы предоставляют поддержку для работы с окнами и пользовательским 
интерфейсом, включая: 


Ш механизм карт сообщений; 
Ш оконный класс; 
Ш диалоговые окна. 


За{!Вед.срр и За! Вед.п 


АТГ, предоставляет СОМ-компонент Кезятат, который выполняет регистрацию в 
реестре. Код реализации находится в 5Га{Вер.В и 51а(Вез.срр. 

А теперь начнем нашу «экскурсию» по АТИ, с изучения поддержки разработки 
СОМ-клиентов. 


Программирование клиента с помощью АТЕ. 


Есть две стороны АТГ: клиентская и серверная. Большая часть поддержки програм- 
мирования находится на стороне сервера, так как АТ, содержит весь код, необ- 
ходимый для реализации элементов управления АсйуеХ. Однако поддержка для 
клиентов, предоставляемая АТГ, тоже весьма интересна и полезна. Давайте рассмот- 
рим клиентскую сторону АТГ. Поскольку шаблоны С++ являются краеугольным 
камнем АТГ, мы сначала поговорим о их. 


Шаблоны С++ 


Несмотря на пугающий синтаксис, концепция шаблонов очень проста. Иногда их 
называют дружественными компилятору макросами (сотарЦег-арргоуе4 тасго$), 
что достаточно точно описывает их сущность. Вспомните: когда препроцессор 
встречает макрос, он подставляет его содержимое в код С++. Недостаток макро- 
сов в том, что они зачастую содержат ошибки и в них полностью отсутствует 
проверка типов. Если вы передадите в макрос некорректный параметр, компиля- 
тор не «заметит» этого, но ваша программа может очень легко «сломаться». Шаб- 
лоны похожи на макросы с проверкой типов. Когда компилятор встречает шаб- 
лон, он подставляет его содержимое подобно макросу, однако выполняет при этом 
проверку типов, тем самым избавляя пользователя от многих проблем. 
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Применение шаблонов для повторного использования кода отличается от всего, 
что вы делали в обычной разработке на С++. Компоненты, написанные на основе 
шаблонов, повторно используют код путем подстановки параметров шаблона, а 
не наследуя функциональность базовых классов. Весь стереотипный код из шаб- 
лонов полностью вставляется в проект. 

Типовой пример применения шаблона — динамический массив. Допустим, вам 
нужен массив для хранения целых чисел, но вам не хочется объявлять массив 
фиксированного размера, так как его длину придется увеличивать по мере надоб- 
ности. Вы создаете массив в виде класса С++. Затем ваш коллега говорит, что ему 
нужен такой же массив, но для чисел с плавающей запятой. Вместо того чтобы 
создать тот же самый код, но с другимтипом данных, вы можете применить шаб- 
лон С++. 

Вот пример решения описанной задачи — динамический массив, реализован- 
ный как шаблон: 


Тетр1афе <с1аз$ Т> с1аз$ БупАггау { 


руб] 1с: 
ОупАггау(); 
`ВупАггау(); // очистка и операции по управлению памятью 
11 АФа(Т Е1етеп*):; // добавление элемента и выполнение операций 


// по управлению памятью 
\019 Ветоуе(1п{+ пТпдех) // удаление элемента и выполнение операций 
// по управлению памятью 
Т бетА*(пТпадех) сопзт; 
11% бе1517е(); 
рг1уате: 
Т» ТАггау; 
11 т_пАггау$17е; 
р 


\0149 УзебупАггау() { 
ОБупАггау<1п{> 1птАггау; 
БупАггау<11оа{т> Г1оа{Аггау; 


1п{Аггау.Ада(4); 
ГЛоатАггау. А99( 5.0); 


1п{Аггау. Ветоуе(0); 
Гоа{Аггау. Нетоуе(0); 


111 х = 1птАггау. ветАт (0); 
ГЛТоае Г = ГЛоафАггау. бетАт(0); 


Ясно, что создание шаблонов полезно для реализации стереотипного кода СОМ, 
и АПТ, использует их именно так. Приведенный пример — лишь один из многих 
способов применения шаблонов. Однако шаблоны позволяют не только указать 
информацию о типе структур данных — они удобны для инкапсуляции алгорит- 
мов. Вы это увидите, когда ближе познакомитесь с АТГ. Изучение АПТ, начнем со 
зтаг-указателей. 
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Зтан-указатели 


Одно из типовых применений шаблонов — зтап-указатели («интеллектуальные» 
указатели). В литературе по «традиционному» С++ обычные указатели называют 
«бессловесными» (Чат). Звучит не слишком ласково, но обычные указатели прак- 
тически ничего не делают — лишь указывают на что-то. Деталями, такими как 
инициализация указателя, клиент занимается сам. 

В качестве примера давайте смоделируем с помощью С++ два класса, имити- 
рующих поведение программистов, один из которых пишет на У15иа1| Ва$1с, а вто- 
рой — на С++. Начнем с создания классов СУВБеоеюрег и ССРРОЕиеюре!. 


с1азз С\УВОеуе1орег { 
риб11с: 
С\УВбеуе1орег() { 
} 
`С\УВОеме1орег() { 
АЕхМеззадеВох( "Я использую \1зиа1 Ваз1с .МЕТ, поэтому ухожу домой пораныше. ") 
} 
У1гфиа1 \0149 боТпемогк() { 
АхМеззадеВох( "Пишу формы. "); 


}; 


с1азз ССРРОеме]орег { 
ру611с: 
ССРРВеуе1орег() { 
} 
7ССРРОеме1орег() { 
АРхМеззадеВох ("Остался на работе и решаю проблемы с указателями. "); 
} 
У1гфиа1 \уо19 ВоТпемогк() { 
АгхМеззадеВох ("Разбираюсь в коде на 0++."); 


У обоих разработчиков есть функции для достижения оптимальной произво- 
дительности. Теперь представьте себе некий клиент примерно такого вида: 


//9зедеуе1орегз. срр 


\0149 Узедеуе]орегз() { 
С\ВОемуе1орег» р\УВбеуе1орег 


// Указатель на УВ Оеуе]орег нужно где-то инициализировать. 
// Но что, если вы забыли проинициализировать 
// и позднее случится нечто вроде: 
1 (рУВОеуе1орег) { 
// Готовьтесь к худшему. 
// Так как р\УВбеуе]орег НЕ РАВЕН МОЕ, он указывает 
// на какие-то случайные данные. 
с->ВоТнемогк(); 
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В данном случае клиент забыл присвоить М1, указателю РУВБегеюрее". (Да-да, 
этого никогда не бывает в реальной жизни!) Так как рУВРереюорег содержит нену- 
левое значение (просто значение, которое оказалось в стеке в этот момент), то 
проверка указателя будет успешной, хотя она должна быть неудачной. Клиент 
«радостно» продолжит выполнение, веря, что все хорошо. Конечно, программа 
«рухнет», так как вызов уйдет в «пустоту». (Кто знает, на что указывает рУВРе- 
геюрет, — вряд ли на что-то, похожее на УВ-разработчика.) Естественно, вам по- 
нравится механизм, который всегда инициализирует указатели. Вот где оказыва- 
ются полезными зтан-указатели. 

Теперь представьте себе другой сценарий. Вы хотите добавить в классы, опи- 
сывающие разработчики, немного кода, который выполнял бы общие для всех 
разработчиков операции. Например, вы желаете, чтобы все разработчики снача- 
ла создали проект, а потом начали кодировать. Посмотрите на вышеприведенные 
примеры разработчиков на УВ и на С++. При вызове РоТре\отё разработчик начнет 
кодирование без соответствующего проекта, и, вероятно, оставит несчастный 
клиент в беде. Вам хотелось бы добавить в классы разработчиков универсальную 
функцию-перехватчик (вооК), чтобы удостовериться в завершении проектиро- 
вания до начала кодирования. В С++ решение этих проблем называется 5$7та7!-ука- 
зателем. Что же это такое? 


Наполнение указателей «интеллектом» 


Зтаи-указатель — это созданный на С++ класс-оболочка обычного указателя. Создав 
класс-оболочку (точнее, шаблон), вы автоматизируете определенные операции 
вместо того, чтобы вынуждать клиент содержать стереотипный код. Один из при- 
меров такой операции — инициализация указателя, дабы не было случайно ‹рух- 
нувших» программ из-за «приблудных» указателей. Другой пример — выполнение 
заданного кода перед вызовом функции с помощью указателя. 

Давайте создадим зтап-указатель для ранее описанной модели разработчиков. 
Вот класс-шаблон 5иа"Деуеюре!: 


Тетр1афе<с1азз Т> 
с1аз$ ЗтагЕОеме1орег { 
Т* т_рОеуе1орег 


риБ11с: 
бтагЕВеуе1орег(Т* р0еуе1орег) { 
АЗЗЕВТ ( рОеуе1орег != М); 
п_рОеуе1орег = р0еуе1орег; 
} 
`бтагЕБеуе1орег() { 
АГхМеззадеВох( "Я умный, поэтому получу зарплату. "); 
} 
Зтаг{Оеуе1орег & 
орегафог=(сопз{ ЭтагОеме1орег& гоеме1орег) { 
гефигп *{П15; 
} 
Т* орегафог->() сопз* { 
АГхМеззадеВох( “К разыменованию указателя. / 
Проверяю, все ли в порядке. "); 
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гетигп п_рбеме1орег; 


Шаблон $та"ШДеерюрег инкапсулирует указатель — любой указатель. Он может 
предоставить типовую функциональность независимо от типа указателя, ассоци- 
ированного с ним. Относитесь к шаблонам, как к дружественным для компилято- 
ра макросам: объявлениям классов (или функций), код которых применим к дан- 
ным любого типа. 

Мы хотим, чтобы зтап-указатель был применим клюбым разработчикам, в том 
числе пишущим на УВ, У15ща1 С++, ]ауа и Реры. Это достигается указанием в на- 
чале определения класса оператора етри ее <с1а55 Т>. В шаблоне объявлен также 
указатель (72 ррезеюрет) на тип разработчика, для которого определен класс. 
Конструктор получает указатель этого типа как параметр и присваивает его 7*_рре- 
георет. Заметьте: конструктор генерирует предупреждение, если клиент передает 
параметр, равный МОМ. 

В дополнение к инкапсуляции указателя 5татеуеюорег реализует несколько 
операторов. Наиболее важным из них является «->» (оператор выбора функции- 
или переменной-члена) — «рабочая лошадка» любого класса зтаи-указателя. 
Именно переопределение оператора выбора превращает обычный класс в зтаг- 
указатель. Обычное использование этого оператора для «бессловесного» указате- 
ля С++ говорит компилятору, что нужно вызвать метод класса (или структуры), на 
который ссылается указатель. Переопределив оператор, вы позволяете перехва- 
тить вызов и выполнить стереотипный код при всяком вызове метода. В классе 
$тапеиеюрег «умный» разработчик проверяет рабочее место перед началом 
работы. (Это немного искусственный пример. В реальной жизни можно, напри- 
мер, вставить отладочный код.) 

Добавление <->» в класс заставляет класс вести себя, как встроенный указатель 
С++. Чтобы быть похожим на указатели языка С++ во всем остальном, класс 5таг(- 
указателя должен реализовать другие стандартные операторы — разыменования 
и присваивания. 


Применение зтан-указателей 


Применение зтап-указателей не отличается от применения обычных встроенных 
указателей языка С++. Начнем с клиента, использующего готовые (неизмененные) 
классы разработчиков: 


\019 Узедеуе]орегз() { 
С\Вбеуе1орег \УВБеуе1орег; 
ССРРВеме1орег СРРОеуме1орег; 


\/Вбеуе1орег. ВоТпемогк(); 
СРРВеуе1орег. ВоТпемогк( ); 


Никаких сюрпризов — выполнение этого кода заставит разработчиков прий- 
ти и выполнить работу. Однако вам нужны «умные» разработчики, т. е. такие, ко- 
торые убедятся в наличии проекта прежде, чем начать кодирование. Вот код, ко- 
торый инкапсулирует классы разработчиков в оболочку-класс зтаг-указателя: 
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\019 Узезтаг{Веме]орег$ { 
СУВОеуе]орег УВОеуе1орег: 
ССРРВемуе1орег СРРОеуе1орег; 


смагЕОеуе]орег<С\ВОеуе1орег> зтагЕ\УВбеуе1орег(&\/ВОеуе1орег); 
стагЕбеуе]орег<ССРРОеуе1орег> зтагСРРОеуе1орег(&СРРОеуе1орег): 


зтагЕ\УВОеуе1орег->ВоТпемогк(); 
эзтагЕСРРВеуе1орег->боТпемогк(); 


Вместо того чтобы обращаться к старым разработчикам (как в предыдущем 
примере), клиент заставляет «интеллектуалов» автоматически подготовить проект 
перед началом кодирования. 


Зтан-указатели и СОМ 


Хотя последний пример служил всего лишь для придания большей динамики рас- 
сказу, этап-указатели полезны и в реальном мире. Одно из таких применений — 
облегчение программирования СОМ-клиентов. 

Зтаи-указатели часто используют при реализации подсчета ссылок. Перенос 
подсчета ссылок на стороне клиента в зтап-указатели имеет смысл, поскольку это 
одна из базовых операций СОМ. 

Вы уже знаете, что СОМ-объекты предоставляют интерфейсы. Для клиентов на 
С++ интерфейсы — это просто чисто абстрактные базовые классы, поэтому ин- 
терфейсы часто трактуются как более-менее обычные классы С++. Однако, как вы 
помните, СОМ-объекты слегка отличаются от обычных объектов С++ тем, что 
существуют на двоичном уровне. Это означает, что они создаются и уничтожа- 
ются с использованием независимых от языка средств. СОМ-объекты создаются 
через вызовы функций АРТ. Многие СОМ-объекты подсчитывают ссылки для опре- 
деления момента, когда они могут самоуничтожиться. После создания объекта 
клиент может обращаться к нему множеством способов через его интерфейсы. 
Кроме того, с одним объектом может взаимодействовать несколько клиентов. В этих 
ситуациях СОМ-объект должен оставаться в памяти, пока на него есть ссылки. Для 
определения момента самоуничтожения служит подсчет ссылок. 

Для поддержки схемы подсчета ссылок СОМ определяет несколько правил 
управления СОМ-интерфейсами со стороны клиента. Первое правило: копирова- 
ние интерфейса должно увеличивать счетчик ссылок объекта на единицу'. Вто- 
рое: клиент должен освободить указатель на интерфейс по окончании работы с 
ним. Подсчет ссылок — одна из труднейших для правильной реализации особен- 
ностей СОМ, особенно со стороны клиента, и поэтому является первым кандида- 
том на применение зтаг-указателей. 

Например, конструктор такого указателя мог бы получать в качестве аргумен- 
та указатель на реальный интерфейс и сохранять его во внутреннем указателе. 
Деструктор мог бы вызывать функцию Кееа$е для интерфейса, чтобы автомати- 


' Клиент обязан предполагать, что у каждого интерфейса свой счетчик ссылок, и дол- 
жен вызвать АЯЯКе} именно для копируемого интерфейса. — Прим. перев. 
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чески освободить интерфейс, когда зтап-указатель удаляется или выходит из об- 
ласти видимости. 

Кроме того, зтап-указатель может поддерживать копирование интерфейсов 
СОМ. Например, представьте, что вы создали СОМ-объект и храните указатель на 
интерфейс. Пусть вам нужно скопировать указатель на интерфейс (чтобы возвра- 
тить его как выходной параметр). На уровне обычной СОМ нужно выполнить 
несколько действий. Сначала надо освободить старый указатель. Затем присвоить 
старому указателю новый. Наконец, вызвать АЧЯКе/ для новой копии указателя. Эти 
действия нужно выполнять независимо от используемого интерфейса, что дела- 
ет описанный процесс идеальным кандидатом для шаблонного кода. Чтобы реа- 
лизовать копирование в классе зта-указателя, нужно всего лишь переопределить 
оператор присваивания, после чего клиент может просто присвоить старому ука- 
зателю новый. $таи-указатель выполнит все операции с указателем на интерфейс, 
облегчив бремя клиента. 


Зтан-указатели в АТЁ 


Большая часть поддержки в АТГ, СОМ-программирования клиентов находится в 
двух классах зтап-указателей: ССотРи и ССотО/ГРи. ССотРИ" — это базовый зтап- 
указатель, инкапсулирующий указатель на СОМ-интерфейс. ССотО/РИ чуть более 
интеллектуален благодаря сопоставлению СОШ (используемого как идентификатор 
интерфейса) со зтап-указателем. Большая часть функциональности ССотРИ вы- 
несена в класс ССотРиВа$е. Рассмотрим сначала ССотРИВафе. 


Класс ССотРНВазе 


Этот класс лежит в основе классов зтаг-указателей, работающих с основанными 
на СОМ функциями управления памятью. Вот листинг ССотРи’Ва$е. 


Тетр1ате <с1аз$ Т> 
с1азз ССотРАгВазе 
{ 
рготестед: 
ССотРгВазе() 1пго\м() 
{ 
р = МГ; 
} 
ССотРЕгВазе(1п{ п№11) 1Вгом() 
{ 
АТЕАЗЗЕВТ (п№и11 == 0); 
(№019 )п№ 11; 
р = М; 
} 
ССотРУгВазе(Т* 1р) пгом() 
{ 
рез, 
ТЕ (р != МЕ) 
р->Ааавет(); 
} 
риб11с: 
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Туредег Т _Р+гС1азз; 
ССотРЕгВазе() ЕИгом() 


{ 
11 (р) 
р->Ве1еазе(); 
} 
орегафог Т*() сопзт 1Игом() 
{ 
гефигп р; 
} 
Т& орегафог»() сопзф йгом() 
{ 
АТЕАЗЗЕВТ (р! =МИЕ); 
гефигп *р; 
} 


// Оператор контроля (аззег{), примененный к орегатог&, 
// обычно свидетельствует об ошибке. Однако если это то, 
// что нужно, явно принимаем адрес переменной-члена р. 
Т** орегатог&() ЕПгом() 
{ 

АТЕАЗЗЕНТ ( р==МУЦ(); 

гефигп &р 
} 
_№М аавВе{Ве]еазе0пССотРЕг<Т>»* орегатог->() сопз +Нгом() 
{ 

АТЕАЗЗЕВТ (р! =МИЕ Е) 

гефигп (_№АдаВетНе1еазе0пССотРЕг<Т>»)р; 
} 
6001 орегатог! () сопзЕ 1Пгом() 
{ 

гефигп (р == №) 


} 
6001 орегафог<(Т* рТ) сопзт 1Вгом() 
{ 
гефигп р < рт; 
} 
6001 орегафог==(Т* рТ) сопзе 1Игом() 
{ 
гефигп р == рт; 
} 


// Освобождаем интерфейс и устанавливаем переменную в № 
у014 Ве1еазе() тПгом() 
{ 
Т» ртетр = р; 
1+е (рТетр) 
} 
р = Ми; 
рТетр->Ве1еазе(); 
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// Проверяем два объекта на предмет эквивалентности 
6001 Т$Едиа106 ест (Т/пкпомп» рОтНег) Епгом() 
{ 
11 (р == рОтпег) 
гефигп Тгие; 


ТЕ (р == МЕ 1! рОфвег == МУ.) 
гефигп Ра15е; // Один равен МИЦ, а второй - нет 


ССотРЕг<ТИпкпомп> рипк1 
ССотРЕг<Т/пкпомп> рипК2; 
р->ОиегуТптегТасе (__ии19о{(Т/пкпомп), (\014**)&рипкК1) 
рОтпег->ОцегуТптегтасе( __ии19о1(ТИпкпомп), (\019**)&рипк2) 
гефигп рипк1 == рипк2; 
} 
// Поключение к существующему интерфейсу (не вызывает АдаВет) 
\019 Афасп(Т» р2) Нгом() 
{ 
ТЕ (р) 
р->Ве1еазе(); 
р = р2; 
} 
// Отключение от интерфейса (не вызывает Ве1еазе) 
Т* Оетасп() {Пгом() 
{ 
Тя р = р; 
р = МЕ; 
гефигп рт; 
} 
НАЕЗОСТ СоруТо(Т»* ррт) ЕПгом() 
{ 
АТЕАЗЗЕВТ(ррт. != М); 
ТЕ (ОРТ == МЕ) 
гетигп Е_РОТМТЕВ; 
*ррТ = р; 
1Р (р) 
р->АдаВег(); 
гефигп $_ОК; 
} 
НВЕЗОЕТ 5е1$11е(Т/пКпомп* рипкКРагеп{) {Пгом() 
{ 
гефигп Аф1$е1С1119511е(р, рипКРагепт); 
} 
НВЕЗУЕТ Ад\1$е(Т/пкпомп* рУпк, сопзе 110% 119, ЕРОМОВО рам) пгом() 
{ 
гефигп АЗ1Ад\у15е(р, рИУпк, 119, рдм); 
} 
НВЕЗИЕТ СоСгеатеТпзтапсе(ВЕРСЕЗТО гс1$149, 
ЕРУМКМОММ рУпкОифег = МЕ 
ОМОАО 9мС1$Сопфехе = СЕ$СТХ_АН:) пгом() 
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АТЕАЗЗЕВТ(р == М.) 
гефигп ::СоСгеатеТпзфапсе (гс1$149, рУпкОифег, 9мС13Соптех+, 
__ци1аот(Т), (\0149**)8р); 
} 
НАЕЗУЕТ СоСгеатеТптзтапсе(ЕРСОТЕЗТН $7РгодТО, 
ЕРИМКМОММ рУпкбитег = МЕ, 
ОМОВО 09мС1$Сопфехе = СЕЗСТХ_АШЕ) ЕПгом() 


СЕ$ТО с1$1а; 
НАЕЗИЕТ Пг = СЕЗТОРгомРго9Т0($7РгодТО, &С1$19); 
АТЕАЗЗЕВТ(р == МЕ); 
11 (ЗУССЕЕБЕВ(Нг)) 
Пг = ::СоСгеатеТпзтапсе(с1$1а, рУпкОитег, 9мС1$Соптехт, 
__ци190т(Т), (\019**)&р); 
гефигп вг; 


} 
тетр1афе <с1азз (> 
НВЕЗОЕСТ ОцегуТптегТасе(0*»* рр) сопзе 1Пгом() 
{ 
АТЕАЗЗЕВТ( рр != №); 
гефигп р->ЧиегуТптегТасе( __ии1901(0), (\019**)рр); 
} 
Т# р; 


ССотРиВазе — довольно простой зтай-указатель. Обратите внимание на пе- 
ременную-член р типа Т — типа, определенного параметром шаблона. Конструк- 
тор выполняет АЧЯКе] для указателя, а деструктор освобождает указатель. Пока 
ничего из ряда вон выходящего. В ССотРИиВа$е тоже есть все операторы, необхо- 
димые для инкапсуляции СОМ-интерфейса. Особого внимания заслуживает опе- 
ратор присваивания, в котором выполняется переприсвоение исходного указателя 
путем вызова функции АЙСотРИА5$1п: 


АТЕТМЕТМЕ АТЬАРТ_(Т/пкпомп») АТ1СотРЕгА$3109п(ТУпКпомп** рр 
ТП9пкпомп* 1р) 
{ 
Те (р != МЕ) 
1р->АааВег!(); 
11 (+рр) 
(*рр)->Ве1еазе(); 
*рр = 10; 
гетигп 1р; 


Функция выполняет «слепое» присваивание указателя, вызывая АЯЯКе] для но- 
вого указателя перед вызовом Кееа$е для старого. В дальнейшем мы познакомим- 
ся с версией этой функции, которая вызывает Оиег/тщег асе. 

Главное преимущество ССотРИиВа$е в том, что он облегчает управление счет- 
чиком ссылок на указатель. Следующий класс ниже в иерархии — ССотРи’. Имен- 
но он применяется в «реальных» приложениях. 
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Класс ССотР! 


Поскольку ССотРи происходит от ССотРИВафе, он наследует все возможности 
последнего по управлению указателями на интерфейс. ССотРИ" облегчает управ- 
ление операциями АЧЯКе/ и Кееа5е и структурой кода. Вот небольшой пример, 
демонстрирующий полезность ССотРи/’. Пусть для выполнения определенных 
действий вам нужны три указателя на интерфейсы: 


\0149 бетоттаРо1пфегз(ЕРИМКМОММ рИпк) { 
НАВЕЗИЕТ г; 
-РРЕАЗТЗТ рРег$151; 
ЕРОТЗРАТСН рО1зратси; 
|РОАТАОВДЕСТ рбата06)ест; 
пг = рупк->ОцегуТпфегРасе(ТТО_ТРегз1$%, (ЕРМОТО *)&рРег$131); 
ТЕ (ЗИССЕЕЩЕВ(Вг)) { 
пг = рупк->ОцегуТпфегРасе(ТТО_ТО1зрафсй, (ЕРУОТО *) 
&р01зратсп); 
ТЕ (ЗОССЕЕВЕВ(Иг)) { 
Вг = рупк->ОцегуТпфегРасе(ТТО_ТБата0Ь ест, 
(ЕРМОТО *) &рбата06 ест); 
1“ (ЗОССЕЕВЕО(Вг)) { 
Вот (рРег$1${, рО1зратсй, рбата06]ест); 
рбата06]ест->Не1еазе(); 
} 
р01зратсп->Ве1еазе(); 
} 


рРегз1$+->Не1еазе(); 


Вы можете использовать (рискуя нарваться на насмешливые комментарии своих 
коллег) очень непопулярный оператор вою для создания более понятного кода: 


\014 бетго{таРо1пфег$ (ЕРУМКМОММ рИпк) { 
НАЕЗИЕТ Пг 
ЕРРЕВУТЗТ рРег$13{; 
[РОТЗРАТСН р01зратсп; 
| РОАТАОВУЕСТ рбата06)ест; 


Пг = рИпк->ОцегуТптегРасе(ТТО_ТРегз1з{, (ЕРУОТО *«)&рРег$1$1); 
ТЕ(РАТЬЕО(Вг)) дофо с1еапир; 


пг = рИпк->ОиегуТпфегтасе(ТТ0_Т01зрафси, (ЕР\УОТО *) &р01зрафсН); 
ТЕ(РАТЬЕВ(г)) 90%о с1еапир; 


пг = рупк->ОиегуТптегРасе(ТТО_ТОафа06]ест, (ЕРУОТО *) &рбата06]ест); 
ТЕ(РАТЕЕВ(Вг)) 900 с1еапир; 


Воте(рРег$1$1, р01зрафсй, рбата0Ь]ест); 


с1еапир: 
1! (рОата0Ь)ест) рбата06]ес{->Ве]еазе(); 
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11 (р01зрафсй) р01зратсн->Ве1еазе(); 
11 (рРегз1$1) рРег$з13{->Ве]1еазе(); 


Такое решение может показаться не слишком элегантным. Применение ССотР/" 
делает код красивее и понятнее: 


\019 бетготтаРо1пфегз (ЕРУМКМОММ рИпк) { 
НАЕЗИЕТ Пг; 
ССотРЕг<ТУпкпомп> рег$131; 
ССотРЕг<ТИпКпомп> а1зратси 
ССотРЕг<Т/пкпомп> дафаобест; 


Аг = рупк->ОцегуТпфегТасе(ТТО_ТРег$1${, (1Р\УОТО *)&рег$1$1): 
1" (РАТЕО(Вг)) гетигп; 


Аг = рУпк->ОиегуТптегРасе(ТТО_ТО1зрафсй, (1Р\УОТО *) &91зратсп); 
1Е(РАТЕЕО(Нг)) гефигп: 


Юг = рУпк->ОиегуТптегРасе( ТТО_ТБафа06)ест, (1Р\УОТО *) &дафаобес*); 
1Е(РАТЕЕО(Вг)) гефигп: 


Оот+(рРегз134, р01зрафси, рВбата0Ьест); 


// Деструкторы вызовут Ве1еазе. .. 


Сейчас у вас может возникнуть вопрос: почему ССотРИ не инкапсулирует 
Оиетупиетасе? В конце концов Онегушегасе — это основное место подсчета ссы- 
лок. Однако для добавления поддержки Онеги/тет асе в зтаи-указатель нужно как- 
то ассоциировать с ним СОТ. Поскольку ССотРи" существовал еще в первой вер- 
сии АТГ, М1сгозой не стала изменять его код, а вместо этого добавила улучшен- 
ную версию — класс ССотО/Ри. 


Класс ССотбИР 
Вот определение ССотО/РИ: 


Тетр1афе <с1азз Т, сопзф 110+ р114 = &_ _ии190Е(Т)> 
С1аз$ ССотОТРЕг : риуб11с ССомРАг<Тт> 
{ 
руб] 1с: 
ССотОТРЕг() ТИгом() 
{ 
} 
ССомОТРЕг(Т» 1р) ЕНгом() : 
ССомРЕг<Т>(1р) 
{ 
} 
ССомОТРЕг(сопзт ССомОТРЕГ<Т, р119>8 1р) 1Игом() : 
ССотРЕг<Т>(1р.р) 
{ 


ГЛАВА 25 Основы АТЁЕ 603 


}; 


} 
ССотОТРЕг(ТИпкпомп» 1р) {Вгом() 
{ 
1 (16 != М) 
1р->0иегуТптегТасе( *р119, (\014 **)&р); 


Е орегафог=(Т* 1р) 1Пгом() 

гефигп зфа{1с_саз{<Т*> (А{1СотРЕгАз$19п( (Т/пкпомп**)&р, 1р)); 
т орегафог=(сопз{ ССомОТРЕг<Т, р119>& 1р) Вгом() 

| гефигп зфа{1с_саз{<Т*>(А{1СотРЕгА$$19п( (Т/пКпомп**)&р, 1р.р)); 
} 


Т» орегафтог=(ТИпКпомп* 1р) Пгом() 
{ 
гефигп зфа{1с_саз{<Т*>(А{1СотОТРАгА$31 дп ( (ТупКпомпя * ) &р 
1р, *р11а)); 


// Специализация класса 
Тетр1афе<> 
с1аз$ ССотОТРЕг<Т/пКпомп, &ТТО_Т/пкпомп> : риб11с ССотРЕг<Т/пкпомп> 


{ 


руб11с: 


йе 


ССомОТРЕг() ЕВгом() 
{ 


} 
ССомОТРАЕг(ТИпКпомп» 1р) ЕПгом() 
{ 
// Запрос интерфейсов 
ТЕ (Пр != М) 
1р->ОцегуТптегРасе ( __ии19от(ТИпкпомп), (№014 **)&р); 
} 


ССомОТРЕг(соп$Е ССотОТРЕг<ТУпКпомп, &ТТ0-ТупКпомп>& 1р) ЕПгом() : 
ССотРЕг<ТУпкпомп>(1р.р) 

{ 

} 

Тупкпомп» орегафог=(ТпКпомп* 1р) ЕВгом() 

{ 
// Запрос интерфейсов 
гефигп Аф1СотОТРЕгА$$19п ( (Т/пКпомп*х )&р, 1р, 

__ц41901(ТУпКкпомп)); 

} 

Цпкпомп* орегафог=(сопз{ ССотОТРЕг<ТИпкпомп, &ТТ0_ТпКкпомп>& 1р) 
ЕИгом() 

{ 
гефигп А{1СотРЕгА$$19п( (Т/пкпомп»*)&р, 1р.р); 

} 
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Разница между ССотОИРИ и ССотРИ — в наличии второго параметра шабло- 
на — риа, описывающего СОШ интерфейса. У данного класса зтап-указателя есть 
несколько конструкторов: конструктор по умолчанию, конструктор копии, кон- 
структор с параметром типа указатель на произвольный интерфейс и конструк- 
тор с параметром типа указатель на /Оипоши. Обратите внимание на последний: 
если разработчик создает объект и инициализирует его простым указателем на 
ЮОпткпоит, то вызывается Оиегуйет асе с параметром шаблона типа СОТО. Кроме 
того, заметьге, что присваивание указателя на /Оиепоит приводит к вызову АЙСот- 
ОРи’А5зюи. Думаем, вам понятно, что внутри этой функции происходит вызов Оиегу- 
Гтетасе с использованием параметра шаблона типа СО. 


Использование ССот@/Р! 
Перед вами пример использования ССотО/РИ в коде СОМ-клиента: 


\019 бетотфаРо1птег$(ТЗотеТптегРасе» рботеТптегтасе) { 
НВЕЗУЕТ вг; 
ССотОТРУг<ТРегз13+, &ТТО_1Рег$1$1> регз15$1{; 
ССотОТРЕг<ТО1зрафсй, &ТТ0_ТО15рафсй> а1зрафсй; 
ССотРЕг<ТВата06]ест, &Т10_ТОата06]ест> дафаоб]ест; 


91зратсий = р5отеТпфегРасе; // неявный вызов ОцегуТптегРасе 
рег$1$+ = рботеТитегтасе; // неявный вызов ОиегуТптегРасе 
Чатаоб]ест = рЗотеТпфегРасе; // неявный вызов ОиегуТпфегРасе 


ОоТ+(регз134, 91зратсй, дафаоб]ест); // передача в функцию, 
// которой нужны ТРег$1${*, 
// ТО1зратсп» и ТОата06 ест» 


// Деструкторы вызовут Ве]еазе... 


ССотО!РИ полезен, если вам необходимо преобразование типов в стиле ]ауа 
или \15ча] Вас. Кстати, в приведенном коде нет вызовов Онегуйие {асе и Кееа$е — 
все они выполняются автоматически. 


Проблемы применения зтаг{-указателей в АТЁЕ 


5тап-указатели порой весьма удобны (как в примере с ССотРИ,, что позволило 
избавиться от операторов 80). К сожалению, они не панацея, избавляющая про- 
граммистов от всех проблем с подсчетом ссылок и управлением указателями. 5тап- 
указатели просто переносят эти проблемы на другой уровень. 

Одна из ситуаций, в которой надо соблюдать осторожность при использова- 
нии зтап-указателей, заключается в преобразовании кода без таких указателей в 
код, использующий их. Проблема в том, что зтай-указатели в АГ, не скрывают 
вызовов АЯЯКе/и Кееабе. Это значит, что вам следует понимать, как работают зтаи- 
указатели, а не следить за тем, как вызываются АдЯКе/и Кееа$е. Например, пред- 
ставьте себе такой исходный текст: 


\014 УзеАпТптегРасе( ) { 
ТО15ратсй» р01зрафсй = МЕ; 
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НВЕЗИЕТ иг = бе+Тне06}ест(&р015ратсп); 

1 (ЗУССЕЕВЕВ(ИГ)) { 
ОМОВО. @мТТСоипт; 
ро1зрафсп->бе{ТуреТпРоСоип{ ( &9мТТСоипт); 
ро1зратси->Не1еазе(); 


} 
который преобразован в код с использованием зтап-указателя: 


\0149 ЦзеАпТптегРасе() { 
ССомРЕг<ТО1зратсй> 915рафсй = МЕ; 


НВЕЗУСТ иг = бетТне06 ест (&915ратсп); 

1 (ЗУССЕЕВЕО(Вг)) { 
ОМОВО дмТТСоипт; 
91зрафси->бетТуреТпРоСоип: ( &дмТТСоип* ); 
41зрафсп->Ве1еазе(); ь 


ССотРи' и ССотОГРИ не скрывают вызовы АдЯКе/ и Кееазе, поэтому «слепое» 
преобразование создает проблему при освобождении зтаг-указателя рейс. 
В приведенном коде Ке/еа$е будет вызываться дважды: первый раз явно при вызо- 
ве абрась->Кееа$е() и второй — неявно при выходе зтап-указателя из области 
видимости. 

Кроме того, в зтап-указатели в АТ. включен неявный оператор приведения типа, 
позволяющий присваивать их обычным указателям. В этом случае подсчет ссы- 
лок становится запутанным. 

Вывод: хотя зтаи-указатели облегчают некоторые стороны программирова- 
ния СОМ-клиента, они не являются «защитой от дурака». Чтобы безопасно при- 
менять зтаг-указатели, нужно хотя бы знать, как они работают. 


Программирование сервера в АТЁ 


Хотя значительная часть АТГ, относится к средствам разработки клиента (напри- 
мер, зтап-указатели и ВЗТК-оболочки), основная часть АТИ, к изучению которой 
мы приступаем, предназначена для поддержки создания СОМ-серверов. Сначала 
мы дадим обзор АТГ, чтобы вам стала ясна общая картина. Затем мы заново реа- 
лизуем модель космического корабля, чтобы исследовать АТГ, $наре ОБесе УЙжага 
и почувствовать, что значит писать СОМ-классы с использованием АТГ. 


АТЁ и СОМ-классы 


Задача разработчика СОМ-класса — установить связь между таблицами функций 
и их реализациями и сделать необходимые вызовы Оиегуйиетасе, А4ЯКеГи Кёеазе. 
Как — дело ваше. Пользователям все равно, как вы этого добиваетесь. Пока мы 
видели два основных подхода — множественное наследование интерфейсов в 
обычном С++ и макросы и вложенные классы в МЕС. Подход АТИ, для реализации 
СОМ-классов отличается от обоих. 
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Сравните подходы С++ и МЕС. Вспомните, что разработка СОМ-классов на С++ 
подразумевает наследование класса С++ хотя бы от одного СОМ-интерфейса и 
написание всего кода такого класса. Далее вам придется вручную добавлять лю- 
бые дополнительные возможности (например, поддержку Рёбрайсь или агрегиро- 
вание). Подход МЕС к написанию СОМ-классов состоит в использовании макро- 
сов, определяющих вложенные классы (по одному на каждый интерфейс). МЕС 
поддерживает (Рё рецсь и агрегирование, поэтому вам не нужно много кода, что- 
бы добавить эти возможности. Однако очень трудно вставить в СОМ-класс новый 
интерфейс без написания вручную значительного объема кода. (Как вы видели в 
главе 22, поддержка СОМ в МЕС основана на нескольких больших макросах.) 

Подход АТИ, к созданию СОМ-класса состоит в создании класса С++, производ- 
ного от нескольких классов-шаблонов. Однако в этих классах уже есть реализа- 
ция //тепоиши. 


\Изца! Ваяю Ргодес5 . ы Ва 
\Изца! С# РиоесЕ$ . Ё 
ыы АТЕ 5егуег — АТЁ бегуег 
3 5еёур ап БероутегЕ РгодесЕ$ Е РиодесЁ \еЬ бегисе 


'ОБег РгодесЁ$ 


виа! 5Еифю зомНопя Ё 2 589 С 


Сизот ЕХКепде: МакеНе 
\АИгаг д Экогед Ро... РгодесЕ 


Рис. 25-1. Выбор АТГ Ргодес! в диалоговом окне Меи Ргодес! 


эресу {не аррисаноп (уре алф Геакиге зирроиЕ Гог Не ргодесЕ. 


Рис. 25-2. Страница Аррисайоп 5ейтв; мастера АТИ, Ргодес! ага 


ГЛАВА 25 Основы АТЕ 607 


Давайте создадим модель космического корабля в виде СОМ-класса. Как все- 
гда, начнем с выбора Ме\ Ргофесё в меню Ее. В открывшемся диалоговом окне Ме\ 
Рго]есе (рис. 25-1) в папке У154а1 С++ Рго}ес(5 выберите АГ, Рго}есе. Назовите про- 
ект, скажем, АТТ$расе$ 1р$уг и щелкните ОК. Откроется окно мастера АТИ, Рго}еси 
УЛгага (рис. 25-2). 


Параметры АТЕ-проекта 


На странице АррИсаНоп $56125 мастера АТГ, Рго]есе \/Л2ага можно выбрать тип 
сервера: Рупапис Мок ГАБгагу (2Ы.), ЕхесшаЫе (ЕХЕ) (исполняемый файл) или 
Зегу1се (ЕХЕ) (сервис). Если сбросить флажок АинЬщеа и выбрать первый пере- 
ключатель, в библиотеку можно включить код прокси/заглушки и использовать 
МЕС в АТГ-проекте. Есть также возможность обеспечить поддержку СОМ+ 1.0. 


Выбор О, в качестве типа сервера приводит к созданию необходимых эле- 
ментов, вводящих РИ, в среду СОМ. Среди них следующие стандартные функции 
СОМ: ОИбе я ОБеса, РИСапИтоааМ№ош, РИКеяжяет5$етьет и РИОитеязм“ет$етиет. Со- 
здаются также корректные механизмы управления временем жизни П.. 
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При желании вы можете запустить ОИ, вне процесса в виде «суррогата», сбро- 
сив в мастере флажок АЦоу/ тег оЁ ргоху/зЁаЬ сое, который позволяет поме- 
стить все компоненты в один двоичный файл. (Обычно код прокси/заглушки 
поставляется как отдельная 2..) Таким образом вы сможете поставлять только 
одну РМ. Если вам очень нужно включить МЕС в свою ПИЛ, установите флажок 
Зиррог МЕС. Это приведет к включению АЁхУЙп.В и АЁхГУ5р.В в файл $1ААЕВ и 
компоновке проекта с текущей версией библиотеки импорта МЕС. Использовать 
МЕС очень удобно, и подчас не хочется «уходить» от этого, но не стоит забывать о 
возникающих при этом зависимостях. Если требуется поддержка сервисов СОМ+ 1.0 
времени выполнения, установите флажок биррог СОМ+ 1.0. 

Если выбрать сервер в виде исполняемого файла, АТИ, Рго}еси ЖЯхага создаст 
код, который компилируется в ЕХЕ-файл. Получаемый файл будет корректно ре- 
гистрировать объекты классов в ОС с помощью СоКезяетС1аз$ОБес! и СоКеоойе- 
С1я55ОБеа. В проект также включен код для управления временем жизни ЕХЕ-сер- 
вера. Наконец, если выбрать вариант 5ег\1се (ЕХЕ), мастер АТГ, Ргодесе УИхага до- 
бавит код поддержки сервисов. 

Применение АТГ, Рго}ес( УЛгагА для написания «легковесного» сервера имеет 
ряд преимуществ. Проект сводит вместе весь исходный код и поддерживает не- 
обходимые инструкции для компиляции каждого файла. 


Создание «классического» СОМ-класса 


После создания СОМ-сервера можно переходить к добавлению в него СОМ-клас- 
сов. К счастью, мастер АТГ, $нир!е ОБесе ЖЙтага (рис. 25-3) значительно облегча- 
ет выполнение этой задачи. Чтобы его вызвать, выберите Ада С1а5$ в меню Рго}есе. 
В открывшемся окне выберите шаблон АТГ, $иар!е ОБеси. 


АТ 5нпр ОБесЕ Уран АТО 


Угасоте {0 {Пе АТ. 5итре ОБесе МЙгагд 
Тв чугаг4 а445 а тре АТЕ оБдесе Ко уоиг риодесе, 


Рис. 25-3. Создание СОМ-класса на основе АТИ, 
с помощью мастера АТЕ Утфые ОБес Тата 


пов 
Примечание Создавая классический СОМ-сервер не забудьте сбросить флажок 


Аниригеа на странице АррИсаНоп $е! 19$ мастера АТГ, РгодесЕ ЖИтага. 
ВЫ НО зева, и дибиди аль банана 
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При генерации нового объекта мастер АТГ, Знар!е ОБесе УЛгага добавляет в 
проект файл исходного кода и заголовочный файл на С++, содержащие реализа- 
цию и определение нового класса соответственно. Кроме того, он добавляет ин- 
терфейс в ШТ-файл. Хотя мастер заботится о содержимом этого файла, вам все 
равно надо до некоторой степени понимать ШТ, чтобы писать эффективные СОМ- 
интерфейсы (вскоре вы в этом убедитесь). 

На странице ОрНоп$ мастера АТТ, паре ОБес! УЛ2агА можно выбрать модель 
потоков (Шгеа4те то4е|, а также интерфейс — двойственный (основанный на 
ШбрейсЬ) или произвольный. Можно также выбрать поддержку агрегирования. 
Кроме того, мастер позволяет легко включить в класс интерфейс бирротЕттотрю 
и точки соединения (соппесцоп ро!1®. Наконец, вы можете агрегировать в свой 
класс маршалер свободных потоков (#тее-Шгеа4е тагзВаег), выбрав в качестве 
модели потоков Во или Меииа1. 


Отделения и потоки 


Для понимания СОМ важно представлять себе, что эта модель построена на аб- 
страгировании (а5зчасиоп), т.е. на сокрытии от клиента максимума информа- 
ции. Например, СОМ скрывает от клиента, является ли СОМ-класс «иотокобезо- 
пасным» (Шгеа4-заЕе). Клиент должен иметь возможность использовать объект как 
он есть, не задумываясь о том, правильно ли объект организует доступ к самому 
себе, т. е. правильно ли он защищает свои внутренние данные. Для описания это- 
го абстрагирования в СОМ введено понятие отделение (арагитепо. 

Отделение определяет контекст выполнения (поток), которому принадлежат 
указатели на интерфейсы. Поток создает отделение вызывая одну из функций 
Соишайзе, СотинайзеЕх или Оеитай2е. Далее СОМ требует, чтобы все вызовы 
методов на основе указателя на интерфейс выполнялись внутри отделения, в ко- 
тором инициализирован этот указатель (иначе говоря, из того же потока, в кото- 
ром была вызвана СоСтещетяапсе). В СОМ определены два типа отделений: од- 
нопоточные и многопоточные. В первом разрешается только один поток, а во 
втором — несколько. В процессе может быть только одно многопоточное отде- 
ление, но произвольное число однопоточных. Отделение может содержать лю- 
бое количество СОМ-объектов. 

Однопоточное отделение гарантирует созданным в нем СОМ-объектам, что 
вызовы их методов синхронизируются через механизм удаленных вызовов (гетойп 
1ауег)', а многопоточное — нет. Разницу между типами отделений можно пояснить 
так: создание СОМ-объекта внутри многопоточного отделения подобно размеще- 
нию данных в глобальной области видимости с возможностью доступа несколь- 
ких потоков; а создание внутри однопоточного отделения — в области видимо- 
сти одного потока. Отсюда следует, что СОМ-классы, которые предполагается раз- 
местить в многопоточных отделениях, должны быть потокобезопасными, а СОМ- 
классы, предпочитающие собственные отделения, могут не заботиться о совмес- 
тном доступе к своим данным. 


` Под удаленным вызовом здесь понимается любой вызов метода интерфейса в другом 
отделении. — Прим. перев. 
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Для СОМ-объекта, располагающегося в отдельном от клиента процессе, вызо- 
вы методов синхронизируются автоматически через механизм удаленных вызо- 
вов. Однако СОМ-объект внутри ОШ, может обеспечить собственную потокобез- 
опасность (например, при помощи критических секций), вместо того чтобы по- 
лагаться на механизм удаленных вызовов. СОМ-класс сообщает о своей пото- 
кобезопасности через параметр реестра Тьгеап Моде! в подразделе С15 раз- 
дела НКЕУ С1.455Е5_КООТ: 


[НКСВ\СЕ$ТО\ {<некий ВИТ0>}\ТпргосЗег\уег32] 
@="С:\<некий сервер>. 0" 
Тргеа91п9Моде]1=<модель потоков» 


где <модель потоков> принимает одно из 5 допустимых значений: 5те, Вор, Егее, 
Араптет или Мешти, впрочем, значение может быть и не указано. АТ, предос- 
тавляет поддержку для всех текущих потоковых моделей. 


Ш 57725 или отсутствие значения означает, что класс может выполняться только 
в основном потоке (первом потоке, созданном клиентом). 

Ш Во означает, что класс потокобезопасный и может выполняться как в одно- 
поточном, так и в многопоточном отделении. Данное значение позволяет СОМ 
использовать для объекта тот же тип отделения, что и для клиента. 

Ш Гуее означает, что класс потокобезопасный. Данное значение заставляет СОМ 
располагать объект внутри многопоточного отделения. 

Ш драйтет означает, что класс не является потокобезопасным и должен разме- 
щаться в собственном однопоточном отделении. 

Ш /ЛМ№ешиа означает, что класс может размещаться в «потоконейтральном» («(Бгеа@- 
пеииар) отделении. Он подчиняется тем же правилам, что и многопоточный, 
но может работать в любом потоке. 


В зависимости от выбранной потоковой модели мастер АПТ, $нир!е ОБесЕ УЛтага 
помещает в класс разный код. Так, при выборе модели Арагтепи класс будет про- 
изводным от ССотОБесчКооЕх с параметром шаблона ССот5таеТьтеааМоде! 


с1а$$ АТЁ_МО_МТАВЕЕ СС1азз1сАТ!$расезй1р : 
риуб11с ССомОБ]естВоотЕх<ССот51п91еТпгеааМоде1>, 
руб11с ССотбоС1а$$<СС1аз$1сАТЕЗрасезй1р, 
&СЕ5ТО_С1а$31сАТЕЗрасези1р>, 
ру611с Т01зратсиТтр1<ТС1аз31САТЕ$расези1р, 
&110_1С1а$$1сАТЕЗрасезн1р, 
&ЕТВТО_ЗРАСЕЗНТРУУВЕ1 > 


Параметр шаблона ССот5$тшеТьтеааМоае! приводит к более эффективным 
стандартным операциям инкремента/декремента в реализации //иёпоит, поскольку 
доступ к классу синхронизируется автоматически. Кроме того, мастер АТИ, $ипре 
ОБесе УЛлага генерирует код класса для добавления в реестр значения потоко- 
вой модели. При выборе в мастере модели Зее класс также будет использовать 
СботутаеТьтеааМоае, но значение параметра Тгеа#теМоде! в реестре останется 
пустым. 
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При выборе моделей ВоВ или Егее в классе будет применяться параметр шаб- 
лона ССотМшИТртеаЯМоае!, что приводит к использованию потокобезопасных 
УЛп52-функций инкремента/декремента Ицепосвейпстетет и ИцепосвкеаБестетети. 
Например, определение класса с моделью Егее выглядит примерно так: 


с1азз АТЁ_М№_\УТАВЕЕ СС]а$31сАТЕЗрасезй1р : 
риуб11с ССотО6]естВоотЕх<ССотМи1{1ТигеадМоде1>, 
руб11с ССомСоС1а$3<СС1а$$1сАТЕЗрасезй1р, 
&01$10_С1а$$1сАТЕЗрасезй1р>, 
риб11с Т01зратсп1Ттр1<1С1аз$$1сАТЕЗрасезй1р, 
&[10_1С1а$31СсАТЕЗрасезй1р, 
&Е1ВТО_ЗРАСЕЗНТРУУВЕ1 > 


При выборе в мастере моделей Во или Егее одноименная строка становится 
значением параметра Тогеа@теМодЕ! в реестре. 


Точки соединения и /Зирро Етготпо 


Добавить точки соединения к СОМ-классу очень просто. Установите флажок Соп- 
песНоп ро", и класс станет производным от /СоппесиопРотИтри в него будет 
добавлена и пустая карта соединений (соппесйоп тар). Чтобы добавить точки 
соединения (например, для поддержки событий) к классу, сделайте следующее. 
1. Определите в ШТ-файле интерфейс обратного вызова. 

2. Используйте генератор прокси из АТГ, для создания класса-прокси. 

5. Добавьте класс-прокси в СОМ-класс. 

4. Добавьте точки соединения в карту точек соединения (соппесиоп ро тар). 


АТ, также содержит поддержку для бирроймЕтгготро. Этот интерфейс обеспе- 
чивает правильную маршрутизацию информации об ошибке по цепочке вызовов. 
Объекты ОТЕ АиютаНоп, использующие интерфейсы с обработкой ошибок, дол- 
жны реализовывать 5ирройЕттотуо. Установка флажка ГбирроцЕггогпЮ в диало- 
говом окне АТГ, паре ОБесЕ УЛ2ага приводит к тому, что АТГ-класс становится 
производным от бирропмЕттоттротри. 


Маршалер свободных потоков 


Установка флажка Егее-Шгеа4е глагзВа!ег приводит к агрегированию в классе 
маршалера свободных потоков СОМ. Как уже говорилось, эта возможность дос- 
тупна только для объектов с потоковой моделью Во! или Меиа!. Это выполня- 
ется путем вызова СоСтешеЕтееТьтеааеаМатр ищет в функции ЕтаСопзйис1. Мар- 
шалер свободных потоков позволяет потокобезопасным объектам обойти стан- 
дартный маршалинг, который происходит при всяком вызове методов интерфейса 
между отделениями, и вызывать методы интерфейса в другом отделении так, буд- 
то они находятся в том же отделении. Тем самым значительно ускоряются вызо- 
вы между отеделениями. Маршалер свободных потоков осуществляет это, реали- 
зуя интерфейс /Магзра/. Когда клиент запрашивает интерфейс у объекта, механизм 
удаленного вызова запрашивает /Матзра! через Оиегушет/асе. Если объект реали- 


612 Часть |У СОМ, Ашотаноп, АсНуеХ и ОЕ 


зует этот интерфейс (а в данном случае это так, поскольку мастер АТГ, $нар!е ОБес! 
УЛгаг4 добавляет также элемент в карту интерфейсов класса, позволяющий Оиеху- 
Пиет/асе обработать запросы от {Матра и есть запрос на маршалинг, то марша- 
лер свободных потоков копирует указатель в пакет маршалинга. При этом клиент 
получает реальный указатель на объект и обращается к объекту напрямую, минуя 
прокси и заглушки. Конечно, при выборе флажка Егее-фгеа4еа тагзВаег было бы 
лучше, чтобы все данные в вашем объекте были потокобезопасными, поэтому будьте 
очень осторожны при установке этого флажка. 


Реализация класса брасе$ р средствами классической АТИ. 


Мы создадим класс космического корабля, используя значения по умолчанию, 
определенные в диалоговом окне АТГ, $ипр!е ОБесе УЙхага. Например, класс бу- 
дет иметь двойственный интерфейс, благодаря чему он будет, в частности, досту- 
пен из ]5сйрЕ на ЖеБ-странице. Кроме того, модель потоков класса — Арагитепь, 
поэтому СОМ будет контролировать основные вопросы синхронизации доступа. 
Единственное, что вам нужно указать мастеру АТИ, Зпар!е ОБесЕ УЙхага, — это 
понятное имя. Введите нечто вроде С1а$$1<АТТ.5расе$ р в поле ввода Вог: Мате 
на странице Матез. 

Нет необходимости задавать другие параметры прямо сейчас. К примеру, не 
нужно устанавливать флажок СоппесИоп рой, потому что мы рассмотрим со- 
единения в следующей главе. Вы всегда можете добавить точки соединения, на- 
брав нужный код вручную. Так выглядит определение класса, сгенерированное 
мастером. 


// СС1а$$1сАТЕЗрасезв1р 


с1а$$ АТЕ_М№0_УТАВЕЕ СС1азз1сАТЕЗрасезн1р : 
риб11с ССот0Б] ес+ВоотЕх<ССот51п91еТпгеаЧМоде1>, 
риб11с ССомСоС1а$$<СС1аз31сАТЕЗрасезнар, 
&СЕ$ТО_С1а5$1сАТЕбрасезй1р>, 
риуб11с 1015$рафсй1Ттр1<1С1а$$1сАТЗрасезп1р, 
&110_ТС1а$з1сАТрасезй1р, 
&1ТВТО_АТЕЗрасев1р$\угЕ16, /*мМадог =*/ 1, /жиМапог =*/ 0> 
{ 
риуб11с: 
}; 

Хотя в АТ. довольно много СОМ-ориентированных классов С++, использован- 
ных для создания космического корабля базовых классов достаточно для пони- 
мания того, как работает АТГ. 

Большинство типовых СОМ-объектов, созданных с помощью АТГ, наследует трем 
базовым классам: ССотОБесКос, ССотСоСйа$ и РёрейсЬ. ССотОБес!Кос! реализует 
Юпкпошт и поддерживает общность класса. Это значит, что в нем реализованы 
лааКе}, Кёеазе и поддержка механизма АП, для Оиегуйиек/асе. ССотСоСа$ реа- 
лизует объект класса и некоторую обработку ошибок. Реализуемый объект клас- 


са знает, как создавать объекты типа СС/а5«АТ[5расезрр. Наконец, в код, созда- 
ваемый мастером, включена реализация 2 рецср, основанная на библиотеке ти- 
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пов, которая создается при компиляции ШГ-файла. По умолчанию реализация 
базируется на двойственном интерфейсе, являющемся интерфейсом Шёрагь, за 
которым следуют функции, определенные в ТГ. 

Как видите, для реализации СОМ-классов АТГ. применяется иначе, чем чистый 
С++. При использовании АТИ. главной частью проекта являются интерфейсы, опи- 
сываемые в ШГ-файле. Добавив функции к интерфейсам в ШГ-коде, вы автома- 
тически добавляете функции к конкретным классам, реализующим эти интерфейсы. 
Добавление будет автоматическим потому, что проекты настроены так, что ком- 
пиляция ШТ-файла создает заголовочный файл С++ с теми же функциями. Все, 
что остается вам сделать после добавления функций к интерфейсу, — это реали- 
зовать их в классе С++. Из ШГ-файла также создается библиотека типов, благода- 
ря чему СОМ-класс может реализовать Шёбраср. Однако АПТ, полезна не только 
при реализации «легковесных» СОМ-объектов, но и является новым средством 
создания элементов управления АспуеХ (см. главу 26). 


Базовая архитектура АТЕ. 


Поэкспериментировав с АТ, вы увидите, насколько она упрощает реализацию СОМ- 
классов. Средства поддержки очень хороши: разрабатывать СОМ-классы инстру- 
ментами \15а1 С++ .МЕТ так же легко, как создавать программы на основе МЕС. 
Вы просто используете АТГ, Ргодесе УЯлага для создания сервера и АТ, $иар!е ОБесе 
УЛлага — для нового создания АТГ-класса. Как и в МЕС, добавьте к интерфейсу 
определения новых функций с помощью С1а55 У1еу,, а затем заполните кодом С++ 
сгенерированные функции. Код, создаваемый АТГ, Рго]есЕ УЛгага, содержит необ- 
ходимую реализацию класса, в том числе Отёпоши, серверный модуль для СОМ- 
класса и объект класса с интерфейсом /С1а55Еасюту. 

Описанный способ написания СОМ-объектов удобнее большинства других. Но 
что точно происходит, когда АТГ, Рго]есЕ У/Л2ага генерирует код? Понимать, как 
работает АТГ, важно, если вы собираетесь расширять свои СОМ-классы и серве- 
ры на основе АТ! за пределы того, что предоставляют АТГ, Рго}есЕ УЛгагА и С]а55 
Мех’. Например, АТ, обеспечивает поддержку такой современной технологии, как 
обособленные (1еаг-оЁ) интерфейсы. К сожалению, нет мастера или флажка для 
реализации обособленного интерфейса. Хотя в АТГ, есть поддержка обособлен- 
ного интерфейса, вам придется часть работы проделать вручную. В этой ситуа- 
ции очень помогает понимание АТ!-реализации /Юипоши. 

Рассмотрим класс СС1а5сАТГ5расезрр более подробно: 


//.СС1аз31сАТЕЗрасезй1р 
с1а5$ АТЁЕ_М№0_УТАВЕЕ СС1а$$1сАТЕЗрасезп1р : 
руб11с ССот06]ес{ВоотЕх<ССот51п91еТпгеа9Моде1>, 
риб11с ССотСоС1аз3<СС1а$з1сАТЕ$расезН1р, 
&(1510_С1а$$1сАТЕбрасезН1р>, 
руб11с ТО15ратсйТтр1<ТС1а$$1сАТЕЗрасез!1р 
&Т10_1С]а$$1СсАТЕбрасезй1р 
&ЕТВТО_АТЕЗрасе 1 р5\угЕ1Ь, /*мМадог =*/ 1, /*мМ1пог =*/ 0> 
{ 
руб11с: 
СС1а$з1сАТЕ$расезй1р() 


21—2064 
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{ 
} 


ОЕСГАВЕ_ВЕСТЗТНУ_ВЕЗОУАСЕТО ( ТОВ_СЕАЗЗТСАТЕЗРАСЕ$НТР) 


ВЕСТМ_СОМ_МАР(СС1а3$1САТЕЗрасезй1р) 
СОМ_ТМТЕВРАСЕ_ЕМТАУ (ТС1а331сАТ.Зрасезй1р) 
СОМ_ТМТЕНРАСЕ_ЕМТВУ( ТО1зратсн) 

ЕМО_СОМ_МАР() 


ОЕСЕАВЕ_РНОТЕСТ_РЕТМАЕ_СОМУТВОСТ( ) 


НВЕЗОСТ Е1па1Сопзгисе() 
{ 
гефигп $5_ОК; 
} 
\014 Е1па1Ве1еазе() 
{ 
} 
риуб11с: 
=. 


ОВУЕСТ_ЕМТВУ_АУТО( __ии1901(С1а$$1САТЕЗрасезВ1р), СС1аз$1сАТЕЗрасези1р) 


Хотя это обычный исходный код на С++, он во многом отличается от кода 
реализации СОМ-объектов. Например, обычно СОМ-класс наследует интерфей- 
сам напрямую, а здесь он производный от шаблонов. Кроме того, в этом классе 
С++ используется несколько, на первый взгляд, странных макросов. По мере изу- 
чения кода вы увидите АП.-реализацию /Оиёпоши, узнаете о методе предотвращения 
«распухания» У и познакомитесь с необычным применением шаблонов. Нач- 
нем с первого макроса, созданного мастером: АТГ_МО_УТАВГЕ. 


Предотвращение «распухания» МЫ 


СОМ-интерфейсы легко описываются на С++ как чисто абстрактные базовые клас- 
сы. Создание СОМ-классов путем множественного наследования (есть и другие 
способы) состоит просто в добавлении интерфейса в качестве базового класса и 
реализации всех его функций. Конечно, это означает, что в выделяемой для ва- 
шего СОМ-сервера памяти размещается значительных размеров 'иаблица вирту- 
альных функций (У) для каждого реализованного интерфейса. Это не страш- 
но, если у вас немного интерфейсов и иерархия классов С++ не очень глубока. 
Однако в таком способе реализации интерфейсов размер таблицы имеет тенден- 
цию к росту по мере добавления интерфейсов и углубления иерархии. АТТ, позво- 
ляет уменьшить потери памяти, вызываемые множеством виртуальных функций, — 
определяется символ: 


#9еГ1пе АТЕ_М№_\УТАВЕЕ __9ес1зрес(поутаб1е) 


Макрос АТЁ_МО_УТАВЕ предотвращает инициализацию в конструкторе объекта 
УЬ, тем самым удаляя эту таблицу и все указатели на виртуальные функции это- 
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го класса из процесса компоновки. Это отчасти уменьшает размер СОМ-сервера 
до размеров последнего в иерархии класса, не использующего директиву Ааес!5рес 
поуаЫе. Выигрыш заметнее в развитых иерархиях классов. Но внимание: небез- 
опасно вызывать виртуальные функции в конструкторе любого объекта, объяв- 
ленного с этой директивой, поскольку указатель на таблицу виртуальных функ- 
ций не инициализирован. 

Вторая строка в объявлении класса говорит о том, что СС/а55 «АТГ расе р 
наследует классу ССотОБесКойЕх. Вот мы и добрались до АГТ-версии ШиЁпои”т. 


АТ--версия /Опкпоит: ССотОЩесо@Ех 


ссотОвБуесЖКоох не венчает иерархию АТ, но он очень близок к вершине. На- 
стоящий базовый класс для СОМ-объекта в АТГ, — это ССотОБесКоо!Ваее. (Опре- 
деления обоих классов находятся в АИСот.В.) При изучении кода ССотОБес!- 
КооВа$е можно обнаружить, что ожидается от базового СОМ-класса на С++. Класс 
содержит переменную-член 72_аишКетипа РУОКГР для подсчета ссылок. В нем есть 
методы ОшетАааКе/, ОшетКееа$е и ОшетОиег/теттасе для поддержки агрегиро- 
вания и обособленных интерфейсов. Изучение ССотОБес! Кой Ех позволяет об- 
наружить /шетиаАааКе}, ПиетпКееа$е и ГшетпаЮиегутеттасе для реального вы- 
полнения подсчета ссылок и механизмы реализации Оиегу/тет/асе для экземпля- 
ров классов с объектной общностью (оБеси 14епиу). 

Из определения класса СС1я5<АТбрасез р видно, что он происходит от ССот- 
ОБесКойЕх и что последний является параметризованным классом-шаблоном. 
Определение ССотОБесЖомЕх таково: 


Тетр1ате <с1аз$ ТпгеадМоде1> 

с1азз ССотОб]естНоо{Ех : руб11с ССотОБ]естВоо{Вазе 

{ 

ру611с: 
ТуредеГг Тпгеа9Моде]1 _ТпгеадМоде] ; 
Туредег _ТпгеадМочде] : : АифоСг1{1са15есе1оп _Сг1{5ес; 
Туреде!г ССот0б]естЁГоскТ<_ТпгеадМоде1> 06)есоск; 


(ЕО№ Тптегпа1Адавет() 
{ 
АТЕАЗЗЕВТ (м_ЧмВеР != -14); 
гефигп _ТигеадМоае] : : Тпсгетеп* ( &п_дмВеГ); 
} 
(ЕО№ Тптегпа1Ве1еазе() 
{ 
1Г9ет _ОЕВИб 
[0№  пВег = _ТпгеадМоде] : : десгетеп* (&п_адмАеР); 
1Е (пАеЕе < -(10№_МАХ / 2)) 
{ 
АТЕАЗЗЕВТ(О && _Т(“Ве]еазе са11е9 оп а ро1птег “ 
“тпаф паз а1геаду Бееп ге1еазед”)) 
} 
гефигпт пНеР 
#е15е 
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УмБмьЪьыуо 


гефиги _ТпгеадМоде] : : Эесгетеп* ( &т_амВе!) 
#епд1 т 
} 


№019 [оск() {т_сг1Езес. 1оск(); } 
\01а Уп1оск() {т_сг1тзес. Уп1оск(): } 
рг1уате: 
_Сг15ес м_сг11зес: 
Я 


ссотОБесКооШх — это класс-шаблон, который зависит от класса потоковой 
модели, передаваемого как параметр шаблона. Фактически АТГ, поддерживает не- 
сколько моделей потоков: однопотоковые отеделения (Зт]е-Тьгеа4еа Арагитепь, 
5ТА), многопотоковые отделения (Ми-Тьгеааеа Арагитепиз, МТА) и свободные 
потоки (Егее ТогеаЯ!лз). Для определения модели потоков в проекте может быть 
один из трех символов препроцессора: _АТГ_5ПУСТЕ ТНКЕАРЕР, АТГ _АРАКТМЕМТ _ 
ТНЕВЕАРЕР или _АТГ ЕЮЕЕ ТНКЕАБЕР. 

Определение _АТГ_$ПУСТЕ_ТНКЕАРЕР в файле З1ЧаЁх.В задает поддержку толь- 
ко одного потока на основе $ТА. Этот вариант пригоден для внешних серверов, 
не создающих дополнительных потоков. Поскольку сервер поддерживает только 
один поток, переменные глобального состояния АТТ, можно не защищать крити- 
ческим секциями, вследствие чего сервер работает эффективнее. Недостаток — 
сервер поддерживает только один поток. Определение _А1Т/ АРАКТМЕМТ_ТНКЕА- 
ДЕР обеспечивает поддержку нескольких потоков на основе $ТА. Это полезно для 
внутренних серверов с моделью отделений (т. е. у которых в реестре задана пара 
«параметр — значение» ТртеайтяМоде=Араттеть). Поскольку сервер этой пото- 
ковой модели может поддерживать несколько потоков, АТТ, защищает свои пере- 
менные глобального состояния при помощи критических секций. Наконец, оп- 
ределение _АТГ_ЕКЕЕ_ТНКЕАРЕР создает сервер, совместимый с любой потоко- 
вой средой. Поэтому АТГ. предохраняет переменные глобального состояния кри- 
тическими секциями, плюс каждый объект имеет собственные критические сек- 
ции для защиты своих данных. 

Перечисленные символы препроцессора просто определяют потоковый класс, 
который передается в ССотОБесЖоймЕх в качестве параметра шаблона. АТИ, пре- 
доставляет три класса потоковых моделей, обеспечивающих поддержку наиболее 
эффективного, но потокобезопасного поведения СОМ-классов внутри каждого из 
трех перечисленных контекстов. Эти классы — ССотМшиТртеаяаМоде№ос$, ССот- 
МшиТрЬтеааМоае и ССот5тяеТртеаяаМоаа. 


С1аз$ ССотМи1{1ТигеаЧ9Моде] №05 
{ 
руб11с: 
этаф1с ИЁОМа МТМАРТ Тпсгетеп* (ЕРЕОМб р) 1пгом() 
{ гефигпТитег1оскедТпсгемепт" (р); } 
эфат1с ИЕОМ@ ИТМАРТ Оесгетепт (ЕРЕОМ6 р) +Пгом() 
{гефигп Тпфег1оскедбесгетет* (р); } 
ТуредеГг ССотРакеСг1+1са1$ес{1оп АифоСг1{1са15ес+1оп; 
ТуредеР ССотРакеСг1{1са15ест1оп Сг111са15есЕ1оп; 
ТуредеР ССотМи1+1ТпгеааМоде1№0С$ Тигеа9Моде1 №05: 
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}; 


с1азз$ ССомМи1{1ТйгеааМоде] 
{ 
риб11с: 
зфаф1с ЦЕОМ№ МТМАРТ Тпсгетеп{ (1РЕОМ р) пгом() 
{гефигп Тптег1оскедТпсгемете (р); } 
ЗТаф1с ЦЕОМ@ МТМАРТ Бесгетепт1 (ЕРЕОМб р) Пгом() 
{гефигп_ Тпфег1оскед0есгемепт (р); } 
Туредег ССотАитоСг1{1са15ес{1оп Ац{фоСг1{1са13есе1оп; 
Туреде{т ССотСг1{1са1Зест1оп Сг1{1са15есе1оп; 
фуредеР ССотМи1{1Тпгеа9Моде1№С5 ТпгеадМоде1№сС5: 


с1аз$ ССот$1п91еТигеааМоае] 

{ 

руб11с: 
зта{1с ОУЕОМ@ МТМАРТ Тпсгетеп* (ЕРЕОМ@ р) ЕПгом() {гефигп ++(#р): } 
З{а{1с ИГОМб ИТМАРТ ОБесгетепт (ЕРЕОМ р) ЕНгом() {гефигп -(*р); } 
Туредег ССотРакеСг1+1са1Зес+1оп АифоСг1{1са1Зесе1оп; 
ТуредеР ССотРакеСг111са1ест1оп Сг1{1са15есе1оп; 
Туредет ССот51п91еТпгеадМоде]1 ТпгеааМоде1 №5; 


Заметьте: в каждом классе две статические функции, истетети Рестететь, и 
ряд синонимов (аНаз) для критических секций. 

ССотМшШТЬтеааМоае и ССотМшиТьЬтеаяМодеМ№оС$ реализуют истетепё и 
Дестетет через вызов потокобезопасных У/1п52-функций Пиепосвейтстетет: и 
1тепосвеаРестетет. ССот5таеТьтеаМоче! реализует эти же функции при помощи 
обычных операторов «++» и «--». 

Помимо различия в реализации инкремента/декремента, три модели потоков 
по-разному используют критические секции. АТТ, предоставляет две оболочки 
критических секций: ССотСийсаесйоп (это обычная обертка вокруг \Уп32 АРТ 
критической секции) и ССотАиюСийся$есйоп (то же, что и ССотСптисабесиоп, 
но с автоматической инициализацией/очисткой). АТГ, также определяет класс 
«фиктивной» критической секции, имеющей те же методы, что и другие классы 
критических секций, но ничего не делающей. Как видно из определений классов, 
в ССотМишТртеаяМоае используются настоящие критические секции, тогда как 
ССотМиШТьтеа4МодеМосС$ и ССот5тшеТртеаЯМо4е! — фиктивные, ничего не 
делающие критические секции. 

Теперь более понятно минимальное определение класса АТИ. При всяком ука- 
зании класса ССотОБесКомЕх в него передается класс модели потоков. СС/я$$С- 
АТрасезрр определен с помощью класса ССот5тшеТртеааМоае, поэтому он 
использует методы этого класса для инкремента/декремента, а также фиктивные 
критические секции. Следовательно, СОа5ясАТбрасез р ведет себя наиболее 
эффективно, так как не должен заботиться о защите данных. Однако вы не при- 
вязаны к этой модели. Если хотите сделать СС/а5КАТГбрасезр потокобезопас- 
ным, просто укажите ССотМиШТргеааМоае! в качестве параметра шаблона для 
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СсСотОБесКооЕх. Тогда вызовы АЯЯКе[и Кееазе автоматически сопоставляются 
корректным функциям /тстетеё и Оестетети. 


АТЁ и Диегутетасе 


Похоже, что в реализации ОиегуГщет/асе АТГ, берет пример с МЕС, так как тоже 
использует поисковую таблицу. Взгляните в середину определения СС/я5«АТ[5расе- 
56р — вы увидите состоящую из макросов карту интерфейсов (име!Расе тар). 
Карты интерфейсов в АТГ, формируют механизм реализации Онме’у/текасе. 

Клиенты используют Оиег/шегасе для произвольного расширения связи с 
объектом. Это значит, что, когда клиенту нужен новый интерфейс, он вызывает 
Оиегутет/асе для существующего интерфейса. Если объект реализует искомый 
интерфейс, он возвращает его клиенту, нет — возвращается ошибка, обозначаю- 
щая, что интерфейс не найден. 

Традиционные реализации Оиег/ишетасе обычно состоят из длинных опера- 
торов #-Шеп. Так, для СОМ-класса с множественным наследованием эта функция 
может выглядеть так: 


С1аз$ СС1аз$1сАТЕ$расезй1р: риуб11с ТО1зратсп, 
1С1а$31сАТЕ5расези1р { 
НАЕЗИЕТ ОцегуТптегРасе(ВТТО г119, 
\019** рру) { 
1(г119 == ТТО_ТО1зратсН) 
*рру = (Т015рафсй*) 111$; 
е13е 11(г114 == Т10_1С1а$31сАТЕ$расезв1р !: 
г119 == 110_ПпКпомп) 
*рру = (ТС]1азз1сАТЕбрасезй1р *) 1113; 
е1зе { 
*рру = 0; 
гефигп Е_МОТМТЕВРАСЕ; 
} 


((ТОпкпомп*) (*рру))->Ааавет(); 
гефигп МОЕВНОВ; 
} 
// АадВег, Ве1еазе и другие функции 
м 


Как вы уже видели, АТГ, использует поисковую таблицу вместо обычного опе- 
ратора {Н-Феп. Эта таблица начинается с макроса ВЕСИУ_ СОМ _МАР. Ниже приве- 
дено его полное определение. 


#9е{1пе ВЕСТМ_СОМ_МАР(х) риб11с: \ 

Туреде{г х _СомМарС1а$$; \ 

зфа+1с НАЕЗИЕТ МТМАРТ _Саспе(\0149* ру, \ 
ВЕЕТТО 119, \0149** рруОб)ест, \ 
ОМОВО РТВ 9м) 4пгом() \ 

{1% 
_СотМарС1аз$* р = (_СомМарС1аз$»)ру; \ 
р->Ёоск():; \ 
НАЕЗИЕТ НВез =. \ 
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—ддд————»<»<_—_————_—_—_—_—_ 


АТЬ: : ССот06] ес{ВоотВазе: :_Саспе(ру, 114, рру0бдесе, ам): \ 
р->п10ск(); \ 
гефигп ПВез; \ 
} \ 
Тупкпомп» _бе{Вам/пКпомп() ЕИгом() \ 
{ АГЕАЗЭЕВТ (_бетЕпг1ез()[0].рЕипс == _АТЕ_$ТМРЕЕМАРЕМТВУ): \ 
гефигп (ТУпкпомпх ) ( (ТМТ_РТВ)В13+_бежЕпг1ез()->9м); } \ 
_АТЕ_ВЕСЕАВЕ_СЕТ_ОМКМОММ(х) \ 
НВЕЗУЁТ _Тпфегпа10иегуТпхегтасе(ВЕЕТТО 119, \ 
\01Ч9** рру0Б]есф) 1Игом() \ 
{ гефтигп Тпфегпа10иегуТптегРасе(+11$, \ 
_бетЕп{г1е$(), 1149, рру0Б)ест); } \ 
сопзт зТа{1с АТЕ::_АТЕ_ТМТМАР_ЕМТВУ* МТМАРТ _бетЕпег1ез() \ 
ЕИгом() { \ 
ЭТа{1с сопзф АТЕ: : _АТЕ_ТМТМАР_ЕМТВУ _епг1ез[] = \ 
{ ОЕВУб_ОТ_ЕМТВУ(х) 


Каждый класс, в котором для реализации ШтЁпоит применяется АТГ, должен 
задать карту интерфейсов для реализации иетпаЮиегутет (асе. Карта интерфейсов 
в АП. состоит из структур, содержащих тройку: идентификатор интерфейса (СХЛО) / 
переменная типа) \/ОЕО/указатель на функцию. Далее показан тип _АТЕ ЛМТ- 
МАР_ЕМТКУ, поддерживающий эту тройку. 


$Егис{ _АТЕ_ТАТМАР_ЕМТВУ 
{ 
соп$т ТТ)» р1149; // Идентификатор интерфейса (110) 
ОмМОНО_РТВ дм; 
_АТЕ_СВЕАТОВААСРОМС» рЕипс; //МУЕЕ:епа, 1:оЕзет, п:рег 
}; 


Первый элемент — это идентификатор интерфейса (СОП)), второй — признак 
действия, выполняемого при запросе интерфейса. Третий интерпретируется по- 
разному. Если рРипс равно константе _АТ[_51МРЕЕМАРЕМТКУ (значение 1), то 4 — 
это смещение внутри объекта. Если рРиис не 0 и не 1, то указывает на функцию, 
которая вызывается при запросе интерфейса. Если рЕипс равно М, то @ озна- 
чает конец поисковой таблицы Онегутет асе. 

Заметьте: в СС/а5<АТТ5 расе р используется макрос СОМ _ПУТЕКЕАСЕ ЕМТКУ. Это 
элемент карты для обычных интерфейсов. Вот этот макрос полностью: 


заег1пе отГзетотс1а$3(рбазе, дег1уед) \ 
((ОМОВО_РТВ) \ 
(зта{1с_саз{<Базе»> ( (дег1\уед*)_АТЕ_РАСКТА@))-_АТЕ_РАСКТМ) 


#аеР1пе СОМ_ТМТЕВРАСЕ_ЕМТАУ(х) \ 
{& АТ: ТТООЕ(х), \ 
оРР5етоРс1аз$(х, _СотМарС1аз$), \ 
_АТЕ_ЗТМРЕЕМАРЕМТВУ } 


СОМ_ЛУТЕКЕАСЕ_ЕМТКУ вносит значение идентификатора интерфейса в структу- 
ру _АТЕ ИМТ МАР_ ЕМТКУ. Кроме того, обратите внимание, как о[5ею/с1а55 преобра- 
зует указатель 125 в нужный интерфейс и помещает полученное значение в поле 
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аи. Наконец, СОМ УУТЕКЕАСЕ_ ЕМТКУ помещает в последнее поле значение 
_ АТЁ УМРЕЕМАРЕМТКУ, чтобы указать на то, что 4 — смещение внутри класса. 

Например, карта интерфейсов для СС/1а5сАТГбрасезбр после обработки пре- 
процессором выглядит так: 


сопзЕ зфа{1с _АТЕ_Т№МТМАР_ЕМТВУ* __$19са11 _бетЕпег1ез() { 
Зфа{1с сопзЕ _АТЕ_ТМТМАР_ЕМТВУ _епг1ез[] = { 
{&ТТО_ТС1а$$1сАТЕбрасезй1р, 
( (ОМОВО) (зфат1с_саз1<1С1аз$1сАТЕбрасезй1р»> 
((_СотМарС1а$$*)8))-8) 
((_АТЕ_СВЕАТОВАВСЕУМЮС» )1)}, 
{&ТТО_ТО1зратсй 
( (ОМОНО) (з+а+1с_сазт<ТО1зратсй*>((_СомМарС1а$$*)8))-8) 
((_АТЕ_СВЕАТОВААСЕУМЮС»)1)}, 
{0, 0, 0} 
# 
гефигп _ептг1ез; 


В настоящий момент класс СС1а5$«АТГбрасезЬ р поддерживает два интерфей- 
са [Са сАТГбрасезр и Рёресь, поэтому в карте два элемента. 

Реализация И\етпаЮиегуще асе в ССотОБесКойЕх получает функцию _Сет- 
71е5 в качестве второго параметра. В этой реализации используется глобальная АТ!-- 
функция АШишетпаЮОиетгтеттасе для поиска интерфейса в карте путем ее простого 
просмотра. 

Помимо СОМ 1МТЕКЕАСЕ _ЕМТКУ, в состав АТ, входят еще 16 макросов, реали- 
зующих различные способы композиции объектов: от обособленных интерфей- 
сов до агрегирования. Далее вы увидите, как расширить интерфейс /С/а55<А115расе- 
5рр путем добавления двух других интерфейсов — /Мойоп и 5 и. Вы также уз- 
наете о странном «звере» в мире СОМ — двойственном интерфейсе (@па1 ицег асе). 


Космический корабль учится летать 


Итак, некоторый АТГ-код у вас есть — что дальше? Поскольку речь идет о СОМ, то 
начать нужно с ШГ-файла. Это может быть новая, незнакомая вам сторона разра- 
ботки ПО. Помните: сейчас такое время, когда распространение и интеграция ПО 
становятся очень важными. Ранее вы могли разобраться в деталях классов С++ и 
«подцеплять» их в свой проект, поскольку вы (как разработчик) видели всю кар- 
тину. Однако в компонентных технологиях (вроде СОМ) все иначе: вы не видите 
всей картины целиком. Очень часто у вас есть только компонент без его исход- 
ного кода. Единственный способ узнать, что он может делать, — вызвать предос- 
тавляемые им интерфейсы. 

Имейте в виду, что разработчики ПО используют массу средств, не только С++. 
Компоненты программируют на У15а| Вазс, ]Дауа, Реры и С. СОМ «сглаживает» 
все углы при интеграции программных блоков, созданных этими программны- 
ми средствами. Кроме того, удаленное выполнение ПО (как внешнего процесса 
на этой же или другой машине) требует межпроцессного взаимодействия. Для 
решения этих проблем и создан язык определения интерфейсов ТПГ, (Ице!гЁасе 
Рейтвоп Гапзиаее,). Вот ТОГ-файл, созданный мастером для нового класса 5расезрр: 
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———————————————————8—8—ж——3———————д—д———дддддд 


1трогЕ “оа191.191"; 
1ирогЕ “0с191.191”; 


[ 
о6]ест, 
ии19(45896187-46ЕЕ-4А07-АЭОС-557377380535), 
0иа1, 
попехфеп$161е, 
ве1рз+г1п0("ТС1азз1сАТЕбрасезнар ТпфегРасе”), 
ро1пфег_дегаиц1(иптачце) 


] 
1п{егРасе 1С1аз$1сАТ($расезв1р : ТО1зратси{ 
}; 
[ 
4и19(Е5Е04043-22АЕ-4700-8643-1АС90402ЕЗЕО), 
уег$1оп(1.0), 
пе1рз1г1п9("АТ.Зрасе$и1р$уг 1.0 Туре Е16гагу”) 
] 
116гагу АТЕЗрасези1румгЕтЬ 
{ 
1трог{116("31901е2.1{16"); 
[ 
4119 (Е485Е21Е-А23С-413Е-А9ЗВ-909318565113), 
ве1р$1г1п9( "С1аз31сАТЕ$расе$И1р С1аз$”) 
] 


с0С1аз$ С1аз$1сАТЕЗрасезй1р 
{ 
[9егаи1*] 1птегРасе ТС1аз$1сАТЕ$расезй1р; 
р. 
} 


Ключевая концепция Ш, состоит в том, что это чисто декларативный (4ес!а- 
гацуе) язык. Он определяет, как клиенты могут общаться с объектом. Помните: этот 
код обрабатывается МШТ-компилятором для получения чисто абстрактного ба- 
зового класса, используемого клиентами на С++, и библиотеки типов, используе- 
мой клиентами на \!5иа! Ваз, ]ауа и других языках. Если вы способны разобраться 
в обычном коде на С, то сможете понять и ШГ. Образно говоря, ШГ, — это С со 
сносками. В соответствии с правилами синтаксиса ШГ, атрибуты всегда предше- 
ствуют элементу, который они описывают. Так, атрибуты предшествуют объявле- 
ниям интерфейсов, библиотек и параметров методов. 

Заметьте: ОТ.-файл начинается с импорта файлов ОааМа! и Оса, который 
подобен включению \Лп4о\з.0 в файлы на С или С++. Указанные ШТ-файлы со- 
держат определения всех базовых элементов СОМ (в том числе определения 
Юткпоит и Дёраср). 

За операторами йирой идет открывающая квадратная скобка (|). В ОЕ в квад- 
ратных скобках всегда помещаются атрибуты. Первый элемент этого ШГ-файла — 
интерфейс /С/азАТИбрасез р. Однако до описания этого интерфейса надо ука- 
зать его атрибуты. Например, дать ему имя (СОТ), указать МПОГ-компилятору, 
что это СОМ-интерфейс, а не интерфейс для стандартного КРС, а также что это 


622 Часть 1\У СОМ, Ашотаноп,. Асй\еХх и ОЁЕ 
Я ее ЕЕ 


двойственный интерфейс (о двойственных интерфейсах см. ниже). Далее идет 
сам интерфейс. Заметьте, что его строение очень похоже на обычную структу- 
ру языка С. 

После описания интерфейсов полезно собрать эту информацию в библиоте- 
ке типов, что делается в следующем разделе ШТ-файла. Кстати, библиотека типов 
также начинается с открывающей квадратной скобки, которая обозначает следу- 
ющие за ней атрибуты. Как всегда, библиотека типов — как и всякий «независи- 
мый» элемент в СОМ — требует имя (СТО). Оператор описания библиотеки со- 
общает МШТ-компилятору, что эта библиотека включает СОМ-класс Сязк«АТГ5расе- 
50р и что клиенты этого класса могут запросить интерфейс АазясАТ15расез р. 


Добавление методов в интерфейс 


В теперешнем виде интерфейс /С/а5<АТИбрасезр неприменим — ему нужны 
один-два метода. Давайте их добавим. При добавлении свойств АмотаНоп в СОМ- 
классы на основе МЕС мы использовали окно С!а5з У1еу’. То же самое мы сделаем 
ВАП. Заметьте: СС/азАТ5расез р наследует 1Аяз«АТ15 расе р. Естественно, что 
1АязясАТГ5расез р — СОМ-интерфейс. Двойной щелчок Аазя«АТ15расезрр в окне 
С1а5$ Уе\ отобразит в окне редактора соответствующий раздел ШТ-файла. 

В данный момент вы можете изменить СОМ-интерфейс прямо в ШГ-файле. Если 
вы добавите таким образом функции и методы, вам придется обратиться к фай- 
лам СазясАТГ5расезр.в и С!аз<АТГ5расезЫр.срр и ввести методы вручную. Про- 
дуктивнее добавлять функции в интерфейсы через С1а55 \1е\ с помощью мастера 
АА Мешфоа УЛгага (рис. 25-4). Для этого в окне (1255 Уе\ просто щелкните ин- 
терфейс правой кнопкой. Вы увидите в контекстном меню команды Ааа Метоа 
и АЧА Ргорегу. Давайте добавим метод СаИ%аНее (вызвать звездный флот). 


#8 АН Зрасебырбуе . 


У’асоте {0 {пе АЧ4 МепоЧ УИгага 
ТРЕ ийгагд а445 а теёНод ко усиг (пбегГасе. 


Рис. 25-4. Добавление метода в интерфейс 


Чтобы добавить метод, введите его имя в поле ввода Мешоа Мате и укажите 
его параметры в полях ввода Рагатегег пате и Рагатегег гуре. Здесь нужно объяс- 
нить одну деталь относительно ШГ. 

Помните, что цель ШТ. — предоставить однозначную информацию о вызове 
методов. В стандартном мире С++ вы часто имеете дело с неоднозначными веща- 
ми, например, с массивами неизвестной длины, что не проблематично, посколь- 
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ку вызывающий и вызываемый используют один и тот же фрейм стека и всегда 
найдется нужное количество памяти. Но так как вызовы методов могут происхо- 
дить по сети, то важно точно сообщить механизму удаленных вызовов, что со- 
бой представляет СОМ-интерфейс. Сделать это можно, добавив атрибуты к пара- 
метрам метода (опять квадратные скобки). 

У метода Са/ЯатЕее! два параметра: число с плавающей запятой (обозначает 
дату) и ВУТВ (описывает получателя). В методе описываются направления пере- 
дачи параметров. Дата передается в метод при его вызове, что обозначается ат- 
рибутом [11]. Строка, описывающая получатель, передается обратно в виде указа- 
теля на ВТК. Атрибут [оц означает направление передачи параметра от объекта 
к клиенту. Атрибут [геуа] означает, что резульгат вызова метода можно присво- 
ить переменной в языке высокого уровня, поддерживающем такую возможность. 


Двойственные интерфейсы 


В главе 23 вы видели интерфейс ОёрасЬ, позволяющий представить функциональ- 
ность объекта (на двоичном уровне) для языков высокого уровня, подобных ] 5спрь 
которые не имеют представления о виртуальных таблицах (у). Чтобы 2 рейсь 
заработал, клиенту нужно выполнить ряд хитроумных действий перед вызовом 
[пооЁе. Сначала клиент получает идентификаторы вызова! затем настраивает 
аргументы типа УАВТАМТ. На стороне объекта декодируются все УАВТАМТ-парамет- 
ры, проверяется их корректность, затем они размещаются в стеке, и вызывается 
функция. Ясно, что это сложная и длительная работа. 

Если вы пишете СОМ-объект и предполагаете, что одна часть клиентов будет 
использовать языки сценариев, а другая — языки, подобные С++, то вы получите 
дилемму: или вы включаете интерфейс Дбракр, или лишаетесь клиентов на язы- 
ках сценариев. Если вы предоставите только Дёрагр, то доступ к объекту из С++ 
будет очень неудобен. Конечно, можно предоставить доступ как через Юёракср, 
так и через собственный интерфейс, но это требует дополнительного програм- 
мирования. Данную проблему решают двойственные интерфейсы. 

Двойственный интерфейс (Чиа! ииегЁасе) — это просто Шёреср с добавлен- 
ными в конец функциями. Например, это «двойственная версия» интерфейса 
Мойоп: 


1пфегРасе ТМоф1оп : риб11с ТО1зратфси { 
У1гфиа1 НВЕЗИЕТ Е1у() = 0; 
У1г{иа1 НАЕЗИЕТ бе{Роз1110п() = 0; 
$ 


Так как /[Мойоп происходит от 2 ресь, то первые семь функций ПМойоп — это 
функции Оёреср. Клиенты, понимающие только Рёраср (например, ]5спро, 
считают этот интерфейс одной из разновидностей Оёраср и для вызова функ- 
ций передают их 015РШ в /игоке. Клиенты, понимающие произвольные интер- 
фейсы на основе у, воспринимают этот интерфейс целиком, игнорируют че- 
тыре функции в середине (относящиеся непосредственно к ёрасрь) и работа- 


' Автор имеет в виду Ч15р-идентификаторы методов и свойств. — Прим. перев. 
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ют с первыми тремя (от /Сиёпош") и последними двумя (от самого /Мойоп) функ- 
циями. На рис. 25-5 показан формат У! для ([Мойоп. 


Шпкпоип 


Юбрасй 


Двойственный 
интерфейс 


Рис. 25-5. Структура двойственного интерфейса 


Во многих реализациях на С++ выполняется загрузка библиотеки типов и де- 
легирование интерфейсу [Гурем)ю неприятной задачи по реализации вызовов /игове 
и сейр5О\атез. Подробности см. в книгах Брокшмидта и Роджерсона. 


АТЁ и Об рав 


ВАГ. реализация По рейсь находится в классе ОёраюсЫтё и делегирует вызовы 
библиотеке типов. Объекты, реализующие двойственный интерфейс, должны вклю- 
чать шаблон ШёбресЫтр в число базовых классов: 


с1аз$ АТЕ_М№0_\УТАВЕЕ СС1азз1сАТЕЗрасезйтр : 

риб11с ССотОбЗесеВоо*Ех<Сбот51потетнгеаамоде1>, 

руб11с ССотСоС1а$$<СС1а$$1сАТЕЗрасезИ1р, &С1$10_С1азз1сАТЕ$расези1р>, 

риуб11с ТО15рафсйТтр1<ТС1аз:1сАТЕЗрасезй1р, &ТТ0_ТС1аз$1сАТЗрасезв1р 
&ЕТВТО_ЗРАСЕЗНТРЗУВЕ1Ь>, 

руб11с ТО1зратспТтр1<1\1$иа1, &1Т0_1\15иа1, 
&ЕТВТО_ЗРАСЕЗНТРЗМУВЕ1Ь>, 

риуб11с Т01зратспТтр1<ТМо{1оп, &ТТО_ТМо*1оп, 
&ЕТВТО_ЗРАСЕЗНТРУУВЕ1 > 


Помимо добавления класса-шаблона ШёресЫтр в список базовых, у объек- 
та должны быть элементы таблицы интерфейсов для двойственного интерфейса 
и для Рёрас, чтобы Оиегу/тетрасе работала правильно. 


ВЕСТМ_СОМ_МАР(СС1аз$1сАТЕЗрасезн1р) 
СОМ_ТМТЕВЕАСЕ_ЕМТВУ(ТС1а$$1САТ|Зрасезп1р) 
СОМ_ТМТЕВРАСЕ_ЕМТВУ (Т01зратсп) 

ЕМО_СОМ_МАР() 


Как видите, аргументами класса-шаблона ЮбрейсИтр являются сам двойствен- 
ный интерфейс, его СОТ и СИ библиотеки типов, хранящей всю информацию 
об интерфейсе. Кроме того, есть ряд необязательных параметров, не показанных 
на рис. 25-5, в том числе номер версии библиотеки типов [причем как сокращен- 
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ной (птог), так и полной (пла]ог) версии] и класс для управления информацией 
о типах. По умолчанию используется АТГ-класс ССотГуретрюНоет. 

В большинстве обычных реализаций Юёресь на С++ в конструкторе класса 
выполняется вызов ГоаЯТурейь и ГГуреь::деЙуретоО/Ки а с последующим со- 
хранением указателя на /Туретуо на весь период существования класса. В АТИ, ре- 
ализация сделана чуть иначе — на основе класса ССотТуретюНо!чее. В этом классе 
есть переменная-член типа указатель на /Туре/и и ‹обертки» основных функций 
Шбрейсь: сеир5О]Уате$ и тооке. 

Клиенты запрашивают двойственный интерфейс, вызывая Онегу[шет/асе для 
ПО 1АазясАТГ5расез р. (Этот же интерфейс клиент может получить, вызвав Ошегу- 
рщег/асе для Рёресь.) При обращении к Са/ЯатНее эта функция будет вызвана 
напрямую (как для любого другого СОМ-интерфейса). 

Когда клиент вызывает /Обреср:тооЁе, вызов передается в функцию /пооке 
класса РёресЫтёЬ, которая делегирует вызов в /игоёе класса ССотТуретюНоеЕт. 
В этом классе загрузка библиотеки типов (вызов ГоаЯТуремь) откладывается до 
первого обращения к /игоке или СеИр5О{\атез. Для обращения к библиотеке типов 
на основе информации в реестре (используя СОТ и номер версии, переданные 
как параметры шаблона) в ССотТуретюНо!ает есть функция-член Сей. Затем 
СсотТуретюНо ет вызывает ГГуре/4ь::Се"уретр для получения информации об 
интерфейсе (указатель на /Гуретуо). Далее все вызовы делегируются этому интер- 
фейсу. Реализация Сей0$ОМатез в РёрасЫтё выполнена аналогично. 


Интерфейсы /МоНоп и 1М/5иа/ 


Чтобы сделать наш СОМ-класс похожим на другие его версии (С++ и МЕС, опи- 
санные в главе 22), нужно добавить в него и в проект интерфейсы /Мойоп и 15. 
Увы, мастера создания интерфейсов в У15иа1 5га41ю МЕТ нет. Для этого сначала 
можно задействовать АТГ, $иар!е ОБесЕ УЛ2ага, чтобы создать объект. Альтерна- 
тивный путь — кодировать вручную. Откройте ШГ-файл, поместите курсор в на- 
чале, где-то после операторов #йпрот, но до оператора Ибгату, и введите опреде- 
ления интерфейсов, как описано далее. 

Зная ШТ, вы автоматически должны начать описание интерфейса с открыва- 
ющей квадратной скобки (|). Помните, что в ШГ, отдельные элементы имеют ат- 
рибуты, и один из важнейших — имя (С0П). Кроме того, очень важно для интер- 
фейса иметь атрибут оБуесЕ, обозначающий принадлежность к СОМ (а не к обыч- 
ному ВРС). Возможно, вы захотите сделать интерфейсы двойственными. В этом 
случае добавьте к атрибутам ключевое слово има, которое приведет к внесению 
в реестр соответствующих записей, необходимых для правильного маршалинга. 
После завершения атрибутов закрывающей квадратной скобкой (]) ключевое слово 
пиеграсе начинает описание самого интерфейса. 

Мы сделаем /Моноп двойственным, а виа! — обычным интерфейсом, чтобы 
показать, как интерфейсы разных типов подключаются к классу Сбрасезр. 


[ 
ов] ест, 
(4и19(692003А4-С689-11СЕ-В337-88ЕАЗ6ОЕЭЕЧЕ), 
9иа1, 
ве1рз1г1п9("ТМо{1оп 1пфегРасе”) 
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1п{егГасе ТМо{1оп : ТО1зрафсп 


{ 
НВЕЗИЕТ Е1У(): 
НАЕЗИЕТ бетРоз11оп([ои%, ге{\а1 ]1оп9* пРо$1410п); 


об] ест, й 
ии19( 692003А5-С689-11СЕ-В337-88ЕАЗ6ОЕЭЕДЕ), 
пе1р$тг1п9( "1Т\1$иа1 1пфегРасе”) 


] 


1пфегРасе Т\1$иа1 : Т/пКпомп 


{ 
НВЕЗИЕТ 01$р1ау(); 
#4 


После введения описаний интерфейсов заново пропустите 1.-файл через 
компилятор МИЛ, для создания новой копии $расезрзуг.В с чисто абстрактны- 
ми базовыми классами /Моноп и Ибис. 

Теперь нам надо добавить эти интерфейсы в класс Сбрасез1р. Это делается в 
два этапа. Первый этап состоит в создании интерфейсной части класса. Давайте 
начнем с /[Мойоп. Добавить интерфейс /Мойоп к С5расезр очень легко — просто 
используйте шаблон Юёрасьытр, предоставляющий необходимую реализацию: 


с1а$$ АТЕ_М№_\УТАВЕЕ СС1азз1сАТЕбрасези1р : 
риб11с ССотОБ]естВооЕх<ССот51п91еТпгеадМоде1>, 
риб11с ССотСоС1аз$<СС1азз1сАТЕЗрасези1р, 
&СЕ$ТБ_С1а$$1САТЕЗрасезй1р>, 

риуб11с 101$ратспТтр1<ТС1азз1сАТЕЗрасези1р, 
&Г1О_ТС1а$$1сАТЗрасезй1р, 
&ЕТВТО_ЗРАСЕЗНТРЗУВЕ1Ь>, 

руб11с ТО1зратспТтр1<ТМо{1оп, &1Т0_ТМот1оп, 
&ЕТВТО_ЗРАСЕЗНТРЗ\УВИ16> 


Второй этап — заполнение карты интерфейсов, чтобы клиент мог запросить 
интерфейс /[Мойоп. Однако наличие в одном СОМ-классе двух двойственных ин- 
терфейсов создает проблему. Запрашивая /Мойоп, клиент должен получить /(Мойоп, 
но когда клиент вызывает Оне’утетасе для РёбрайсЬ, какую версию этого интер- 
фейса он получит: диспетчерский интерфейс /С/я55<АИ5расез р или 1[МойНоп? 


Множественные двойственные интерфейсы 


Все двойственные интерфейсы начинаются с 7 функций интерфейса РбрейсЬ. 
Проблема возникает, когда клиент вызывает Оиегуриет асе для По_Шбрейсь. Как 
разработчик, вы должны выбрать версию /Оёрейсь, передаваемую клиенту. 

Интерфейс, возвращаемый Онегу/шет асе, задан в карте интерфейсов. В АТИ, есть 
особый макрос для обработки двойственных интерфейсов. Сначала рассмотрим 
имеющуюся карту интерфейсов: 
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ВЕСТМ_СОМ_МАР(СС1а$$1сАТЕЗрасезв1р) 
С0М_ТМТЕВРАСЕ_ЕМТВУ (1С1а3$1САТ.Зрасезй1р) 
С0М_ТМТЕВРАСЕ_ЕМТВУ( ТО01зратсп) 

ЕМО_СОМ_МАР() 


Когда клиент вызывает Оне’/тщет/асе, АТГ. проходит по таблице в поисках ПО, 
совпадающего с запрошенным. Приведенная карта содержит два интерфейса: 
Аязя«АТГ5расез р и Рёбра. Если нужно добавить к классу СС1а5«АТГ5расезр 
еще один двойственный интерфейс, то нужен другой макрос. 

Для обработки множественных двойственных интерфейсов в АТГ, существует 
макрос СОМ ЛУТЕКЕАСЕ ЕМТКУ2. Чтобы Оиегуршек/асе работала правильно, нуж- 
но только решить, какую версию получит клиент, запросив Шёрась, например: 


ВЕСТМ_СОМ_МАР(СС]а$$1сАТЕ$расезн1р) 
СОМ_ТМТЕВРАСЕ_ЕМТВУ(ТС]а$$1сАТЕЗрасезв1р) 
СОМ_ТМТЕВРЕАСЕ_ЕМТВУ (ТМо{10п) 

СОМ_ТМТЕВРАСЕ_ЕМТВУ2 (101зрафсп, ТС1а$$1сАТЕЗрасезн1р) 

ЕМО_СОМ_МАР() 


В данном случае клиент при запросе (Оёбракр получит указатель на /С/а5$<АТГ- 
5расезр, первые 7 функций которого являются функциями ЮШбракр. 

Добавить недвойственный интерфейс еще проще — добавьте интерфейс в спи- 
сок наследования: 


с1азз$ АТЕ_№0_\УТАВЕЕ СС1а$$1САТЕЗрасезй1р : 
риб11с ССотОБ]ес{ВоотЕх<ССот51п91еТпгеааМоде1>, 
риб11с ССомСоС1аз$<СС1а$31сАТЕ$расезй1р, 
&СЕ$Т0_С1аз$1сАТЕбрасезй1р>, 
риб11с ТО01зратснТтр1<1С1аз$1сАТЕбрасезй1р, 
&ТТ0_1С1а$$1сАТЕЗрасезй1р, 
&ЕТВТО_ЗРАСЕЗНТРЗМУВЕТЬ>, 
риб11с Т01зрафспТтр1<ТМо{1оп, &ТТО_ТМот1оп, 
&[ 1ВТО_ЗРАСЕЗНТРЗМУВЕ1Ь>, 
риб11с ТО01зрафсйТир1(Т\1$иа1, &ТТО_1\1$иа1, 
&ЕТВТО_ЗРАСЕЗНТРЬМУВЕ1 > 
{ 


# 
и добавьте запись в карту интерфейсов: 


ВЕСТМ_СОМ_МАР(СС1а$31САТЕ$расезв1р) 
С0М_ТМТЕВРАСЕ_ЕМТВУ(ТС1а$$1сАТЕЗрасезй1р) 
СОМ_ТМТЕВРАСЕ_ЕМТВУ (ТМо{10п) 

СОМ_ТМТЕВРАСЕ_ЕМТВУ2 (Т01зрафсй, 1С]а331сАТЕ$расези1р) 
С0М_ТМТЕВРАСЕ_ЕМТВУ(Т\1зиа1) 
ЕМО_СОМ_МАР() 


Теперь у вас есть функциональный, работающий, саморегистрирующийся СОМ- 
сервер, который поддерживает понятную для СОМ «игру в компоненты». Но оказы- 
вается, в У15иа! С++ .МЕТ есть другой способ реализации СОМ-серверов: путем про- 
граммирования на основе атрибутов 


628 Часть У СОМ, Ащотаноп, АсйуеХ и ОЕ 


Программирование с применением атрибутов 


Вместо обеспечения поддержки СОМ путем применения шаблонов С++ вы може- 
те прибегнуть к более декларативному подходу — атрибутам. Классическое АТТ-- 
программирование предусматривает поддержку /Юипоишт за счет шаблонных 
классов и макросов карты интерфейсов, а в программировании на основе атри- 
бутов (аищеа ргозгатили1?) достаточно объявить СОМ-класс как таковой пря- 
мо в исходном коде. 

Создадим тот же сервер 5расезШр, но на основе атрибутов. Во-первых, создайте 
новый АТГ-проект, установив флажок АинЬшеа на странице АррИсацоп $е 19$ 
мастера АТГ, Рго]есЕ У/лага. Затем с помощью мастера АТТ, $пар!е ОБесе УЛ2ага 
создайте класс с атрибутами (айиБлиеа с1а5$), назвав его Ай’фшедАТГ5 расе Яр. 
Страница ОрНоп$ такая же, что и для классического СОМ-класса: вы вправе вы- 
брать потоковую. модель (Арагитепь, Егее, Во или Меи!га!), а также поддержку 
бирроиЕ топ и/или точек соединения. Однако код, сгенерированный масте- 
ром, немного отличается от классического АТГ-кода. 


// ТАЕЕгаитедаАТЕ$ расезн1р 


[ 
об]ест, 
(19 ("48868580-0071-4038-АРС1-3012С7864800”), 
4иа1, Пе1рз%г1п9д("”ТАЕЕг1БифедАТЕ$расезн1р ТптегРасе”) 
ро1птег_дегаи1* (ип1дие) 
] 


__1пеггасе ТАг1БифедАТ. расе вар : ТО1зратси 


{ 

| 

// САЕЕгаитедаТЕ$ расезв1р 
р 


сос1аз$, 
{Пгеа91п9(“араг{тепт”), 
\1_рго919 ( "АЗ г1битеддТЕ$ расе н1р5\г. АЕЕг1итеддтЕ”) 
рго919 ( "АтЕг1битедаТЕ$ расе н1р$уг. АЕг1ритечд. 1”), 
уег$10п(1.0), 
ци19 ( "СЕО7ЕВА4-0858-4А81-АО1С-С1271084А1А?2”), 
пе1рзг1п9( "АТ г1итедАТЕЗрасе$1р С1азз”) 
] 
С1а$$ АТЕ_М№0_\УТАВЕЕ САТЕг1БитедаТЕ$ расе и1р : 
риуб11с ТАЕЕг1итеддТЕ расезв1р 
{ 
риб11с: 
САЕЕг1БитедАТЕ$ расезв1р() 
{ 
} 
РЕСГАВЕ_РВОТЕСТ_ЕТМАЕ_СОМУТВУСТ() 
НВЕЗИСТ Р1па1Сопзгисе() 
{ 
гетигп 5_ОК; 
} 


\019 Е1па1Ве1еазе() 
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{ 

} 
риб11с: 
}; 


Поддержка СОМ, обеспечиваемая шаблонами на С++ в классическом АТИ, при- 
вносится в АТТ-сервер через ОГ провайдеров (ргоу14ег О1.). Заключенные в квад- 
ратные скобки атрибуты в начале файла указывают компилятору добавить в класс 
САНПЬШечАТ 5 расе$ р инфраструктуру СОМ. Это намного проще, чем отслежи- 
вать такие классы (например, ССотОБесКомЕх и ССотСоС1а$$) и макросы (на- 
пример, ВЕСУ СОМ _МАР). : 

Дальнейшая разработка СОМ-класса проста. Допустим, нужно добавить в класс 
интерфейсы /Мойоп и 1/75. В «АТГ, с атрибутами» довольно просто внести ин- 
терфейсы прямо в исходный код АТГ, например так: 


[ 
об]ест, 
ци19("692003А4-С689-11СЕ-В337-88ЕАЗ6ОЕЗЕДЕ”) 
Чиа], 
ве1рз{г1п9("ТМот1оп 1птегРасе“) 
] 
__1пфегРасе ТМоф1оп : Т015ратсй 
{ 
НВЕЗИЕТ Е1у(); 
НВЕЗИЕТ бетРоз11оп([оит, ге{\а1 ]10п9* пРо$110п); 
# 
[ 
об)ест, 
ци19("692003А5-С689-11СЕ-В337-88ЕАЗ6БЕЭЕДЕ"), 
пе1р${г1п9(”Т\/1$ца1 1птегРасе”) 
] 
__1пфегРасе Т\1зиа1 : ТпКпомп 
{ 
НАЕЗИЕТ 013р1ау(); 
}; 
// и так далее... 


Атрибуты перед ключевым словом _ йе асе описывают СОМ-интерфейсы как 
таковые, точнее как двойственные интерфейсы. После описания интерфейсов в 
исходном коде вы можете реализовать интерфейсы класса, просто щелкнув его 
правой кнопкой в окне С1а$$ У1е\”, последовательно выбрав в контекстном меню 
Ааа и Паретепь Ииегасе. Вы можете выбирать интерфейсы из зарегистрированных 
библиотек типов или из интерфейсов, перечисленных в исходном коде ([Мойоп 
и /Убиай. У15а! За о МЕТ создает функции-заглушки — вам достаточно запол- 
нить их текстом. 

В результате получается полноценная СОМ ПЦ, с нужными входными точка- 
ми: РИМат, Ойсеа$$ОБесЕ, ОИСапИтоаапо, ОПКеЯет$етет и РИОптеяяетзетиее. 


Издание второе 


Самое авторитетное руководство 
по программированию в среде 
М!сгозоЯ Миа! С++ .МЕТ 


Эта книга адресована профессионалам, желающим заняться 
созданием приложений .МЕТ, используя возможности Миа! С++ 
и Мсго$ой .МЕТ Егатемогк. Вы найдете здесь пошаговые 
инструкции и подробное обсуждение методов программирования, 
инструкций и решений, а также рассказ о новинках Мсго5$ой 
Мзиа! С+-+ .МЕТ. Вы получите самые подробные сведения 

о синтаксисе языка, инструментах и АР!-интерфейсах, 

а отопытных экспертов — советы и рекомендации по экономии 
времени и сил при разработке программ. 


В книге рассматриваются: 


Основы: \\/пдом$ и Мзиа! С+-+ .МЕТ, МЕС и мастера Миа! С++ 
.МЕТ, классические @0|-функции, диалоговые окна, элементы 
управления и элементы АсН\ех, управление памятью в \/т32, 
обработка сообщений \\тао\м/$, многопоточные приложения. 


Архитектура «документ-вид» в МЕС: меню, быстрые клавиши, 
поля ввода с форматированием и окна свойств, документ 

и его представление, $01-, МО]!- и МТ|-приложения, печать, 
разделяемые окна и представления данных, контекстная 
справка, ОЦ-библиотеки, МЕС-программы без классов 
«документ» и «ВИД». 


СОМ, АщотаНоп, Ас мех и ОГЕ: интерфейс 1Ю!зра{сп, 
передача данных через буфер обмена и операцией ОЕ 
дгаб-апа-агор, АТЕ, АсЧуеХх-элементы, шаблоны О\Е ОВ. 


Создание приложений для Интернета: ТСР/\Р, ММп5оск 
и М/пшеф, упатс НТМЕ, АТЕ $егуег. 


.МЕТи дальше: платформа .МЕТ, взаимодействие .МЕТ 
с управляемым С++, \ММпаом/$ ЕГогт$, @01+ и М/еб-сервисы 
на основе С++, Мсго$ой АБО.МЕТ. 
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